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AT&T UNIX SYSTEM V/386 
RELEASE 3.2 
RELEASE NOTES 



Preface 

AT&T UNIX System V/386 Release 3.2 successfully merges the functional- 
ity of the AT&T UNIX System V/386 and Microsoft XENIX System V/386 
operating systems into a single UNIX operating system for the Intel 80386 
based computer. It provides an environment capable of running current appli- 
cation executables developed for earlier releases of AT&T UNIX System V/386 
as well as Microsoft XENIX System V/386. The product provides support for 
application executables developed for AT&T UNIX System V/286 Release 2 
and Microsoft XENIX System V/286. 

These Release Notes describe how AT&T UNIX System V/386 Release 3.2 
compares to both AT&T UNIX System V/386 and Microsoft XENIX 
System V/386, focusing on new or modified features and functionality. In 
addition, these Release Notes contain a list of known software problems and 
workarounds. 

Consult the Product Overview for a complete description of the functional- 
ity and components (software and documentation) of AT&T UNIX 
System V/386 Release 3.2. 
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Notational Conventions 



The following notational conventions are used throughout these Release 
Notes: 



bold 



italic 



constant width 



<> 



<"char> 



[ ] 



User input, such as commands, options to com- 
mands, and names of directories and files, appear 
in bold. 

Names of variables to which values must be 
assigned (such as filename) appear in italic. 

UNIX System output, such as prompt signs and 
responses to commands, appear in constant 
width. 

Input that does not appear on the screen when 
typed, such as passwords, keys used as com- 
mands, or <RETURN> and other special keys, 
appear between angle brackets. 

Control characters are shown between angle 
brackets because they do not appear on the screen 
when typed. The circumflex (") represents the 
control key (usually labeled CTRL). To type a 
control character, hold down the control key while 
you type the character specified by char. For 
example, the notation < " D> means to hold down 
the control key while pressing the d key; the letter 
d will not appear on the screen. 

Command options and arguments that are 
optional, such as [-msCj], are enclosed in square 
brackets. 

The vertical bar separates optional arguments 
from which you may choose one. For example, 
when a command line has the format 

command [argl I arg2] 

you may use either argl or argl when you issue 
command. 
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Notational Conventions 



An ellipsis after an argument means that more 
than one argument may be used on a single com- 
mand line. 

commflnd(number) A command name followed by a number in 

parentheses refers to the part of a UNIX System 
reference manual that documents that command. 
(There are two reference manuals: the 
User's /System Administrator's Reference Manual 
and the Programmer's Reference Manual.) For 
example, the notation cat(l) refers to the page in 
Section 1 of the User's/System Administrator's 
Reference Manual that documents the cat com- 
mand. 

In sample commands, the dollar sign ($) is used as the shell command 
prompt. This is not true for all systems. Whichever symbol your system uses, 
keep in mind that prompts are produced by the system. Although a prompt is 
sometimes shown at the beginning of a command line as it would appear on 
your screen, you are not meant to type it. In addition, some examples may 
use the default superuser prompt, the pound sign (#). As with the system 
prompt, you are not meant to type the superuser prompt. 
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Foundation Set Software Packages 



The Foundation Set is the fundamental UNIX System software product 
supplied with your system. The Foundation Set provides you with the UNIX 
operating system kernel and a basic set of utilities. The Foundation Set con- 
sists of the following separately installable packages: 

■ Base System Package 

■ Editing Package 

■ Remote Terminal Package 

■ Security Administration Package 

■ 2 Kilobyte File System Utility Package 

■ Network Support Utility Package 

■ Remote File Sharing Package 

■ XENIX File System Utility Package 

The Base System Package is the minimal required UNIX System. The 
other Foundation Set packages are optional, and you do not need to install 
them if you do not require the utilities they provide. 
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Features of AT&T UNIX System V/386 
Release 3.2 

AT&T UNIX System V/386 Release 3.2 provides the following new 
features. Consult the Product Overview for an overview of all the features. 



XENIX System V Compatibility 

AT&T UNIX System V/386 Release 3.2 provides full binary and source 
code compatibility with applications developed for Microsoft XENIX 
System V/386, Microsoft XENIX System V/286, AT&T UNIX System V/386, 
and AT&T UNIX System V/286. The following list describes the level of 
XENIX System V support: 

■ Source code written for Microsoft XENIX System V/386 programs and 
applications can be compiled and linked on AT&T UNIX System V/386 
without having to modify the source code. 

■ Binary applications developed for Microsoft XENIX System V/386 
(Release 2.2.0 and later) and Microsoft XENIX System V/286 
(Release 2.0 and later) can be run on AT&T UNIX System V/386 
without having to recompile the applications. 

■ The structure of the AT&T UNIX System V/386 file system allows both 
XENIX System V and UNIX System V binary applications to be executed. 
It also supports the mounting of a XENIX System removable file system 
(with the XENIX file system add-on installed). 

■ Support for XENIX System call extensions enables programs to run as 
they did under the XENIX System. 

■ All device driver support routines available under Microsoft XENIX 
System V/386 are available in AT&T UNIX System V/386. 

In addition to the program interface, several XENIX System V commands 
have been added for ease of use and compatibility. Tools are provided that 
allow the installation of all existing UNIX System and XENIX System packages. 

The following sections describe the XENIX System calls that are not sup- 
ported in Release 3.2 and those that are supported, but have slightly different 
functionality. 
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XENIX System Calls that Function Differently in Release 3.2 

The following XENIX System calls are supported in AT&T UNIX 
System V/386 Release 3.2, but function differently in the XENIX System: 

execsegO 

The XENIX execsegO system call has been added to Release 3.2. This system 
call provides a means by which data can be executed. The execsegO system 
call returns a far pointer (selector and offset) to the start of the data segment. 
To execute the data, you must set the offset portion of the far pointer returned 
by execseg to the address of the data to be executed. Then, you must perform 
a far (intersegment) call through the far pointer. Because the AT&T compiler 
does not support the " near " or " far " keywords (which correspond to intra- 
and intersegment addressing, respectively), it is not possible to use the 
execsegO system call directly in C language. To use execsegO, you must use 
in-line assembly instructions, as shown in the following example. 
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typedef struct fcall { 

int ( *f c_of f set ) ( ) ; 

short fc_selector; 

} fcall_t ; 

fcall_t codeitem; /* far pointer »/ 

fcall_t 'fcptr = Sicodeitem; /• pointer to far pointer •/ 

extern char code_in_data [ ] ; /* data to be executed */ 

extern void execseg(); /* void due to lack of far •/ 



/* keyword */ 



execseg( ) ; /* execseg returns far pointer */ 

asm( "pushl Xedi"); /* in eax,edx. This assembly */ 

asm( "movl fcptr.Xedi); /* code places this return val •/ 

asm( "movl Xeax , ( %edi ) " ) ; /* in *fcptr */ 

asm( "movl Xedx , 4 ( Xedi ) " ) ; 

asm("popl Xedi"); 



/* set the offset of the far pointer 
of the data to exec •/ 



f cptr->f c_of f set = (int (•)()) code_in_data ; 



asm( "pushl Xedi"); /* do a far call into the data */ 

asm( "movl fcptr, Xedi"); /* pointed to by fcptr •/ 

asm("lcall *(Xedi)"); 

asm( "popl Xedi"); 



Note that any data to be executed must return by means of an " Iret " instruc- 
tion. 

In addition, only one call to execsegO is required for executing data. After 
the initial call, multiple execsegO calls have no effect. 

To remove the ability to execute data, use the unexecsegO system call. 
This system call disables execsegO by invalidating the selector execsegO 
returns. As a result, any attempt to perform a far (intersegment) call through 
the pointer returned by an earlier execsegO call causes a segmentation viola- 
tion. As with execsegO, multiple calls to unexecsegO have no effect after the 
initial call. 

Neither execsegO nor unexecsegO accepts arguments or returns errors. 
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fcntlO and lockfO 

In Release 3.2, file locks placed using the fcntlO or lockfO system calls are 
always enforced, if the source is compiled on Microsoft XENIX System V/386. 
However, these file locks are not always enforced when the source is compiled 
on Release 3.2. If the source is compiled on Release 3.2, you must use the 
chmod(l) command to guarantee enforcement of the file locks. 

Microsoft XENIX System V/386 binaries that call fcntlO with cmd 
LK_GETLK and flock l_type F_UNLCK can receive blocking information. 
This feature is not supported in Release 3,2. 

Microsoft XENIX System V/386 binaries that call fcntlO and/or lockfO 
always have their read and write access permissions checked. When compiled 
on Release 3.2, however, read and write permissions are checked only when 
trying to set a lock. 

Microsoft XENIX System V/386 binaries that call fcntlO to set a non- 
blocking lock will receive EAGAIN if the call would block. On Release 3.2, 
binaries receive EACCES. 

lockingO 

In Release 3.2, file locks placed using the XENIX lockingO system call are 
always enforced. 

ptraceO 

In Release 3.2, the ptraceO system call is not supported for XENIX System 
binaries. XENIX System binaries that rely on ptrace to work will not work on 
Release 3.2. To make their code run on Release 3.2, you will have to modify 
their XENIX System code to use the UNIX System version of ptrace. 

ulimitO 

Microsoft XENIX System V/386 binaries that call ulimitO with the cmd argu- 
ment set to 2, cannot increase their limit beyond the maximum number of 
blocks that are representable in a 512-byte block file system. This restriction 
is not enforced when the source is compiled on Release 3.2. 

unameO 

The utsname structure returned from unameO is a different size, depending on 
whether you compile on Microsoft XENIX System V/386 or on Release 3.2. On 
Microsoft XENIX System V/386, there are extra fields at the end of the struc- 
ture. 
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XENIX System Calls Not Supported in Release 3.2 

The following XENIX System calls are not supported on AT&T UNIX 
System V/386 Release 3.2: 

brkctlO 

nfs_sys() 

proctlO 

shutdownO 

In Release 3.2, use the uadminO system call with its A—SHUTDOWN com- 
mand. 

stkgrowO 

Users will probably not be affected by the fact that this system call is not sup- 
ported in Release 3.2. 

swapaddO 

In Release 3.2, use the sysi86(SI86SWPI) system call. 
xlistO and fxlistO 

The XENIX xlistO and fxlistO C-library functions are not supported by 
Release 3.2. Users must rewrite programs that use these two subroutines, 
using the 3.2 nlistO subroutine, as described in the Programmer's Guide and 
Programmer's Reference Manual. 

Installing XENIX System Devices 

XENIX System users should note that XENIX System device names (such as 
floppy drive devices) have been linked to their equivalent device names on 
AT&T UNIX System V/386 Release 3.2. 

XENIX-286 Application Execution 

This release of the UNIX System contains a Microsoft XENIX System V/286 
utility^that allows Microsoft XENIX System V/286 {Microsoft Release 2.3 and 
SCO Release 2.3.2) programs to run on the Intel 80386 processor under 
AT&T UNIX System V/386 Release 3.2. 
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For more information about the XENIX-286 feature, see the x286emul(l) 
manual page in the Programmer's Reference Manual. 

Features from Microsoft XENIX System V/386 

This section describes XENIX System utilities that have been added and 
Release 3.1 utilities that have been modified to support Microsoft XENIX Sys- 
tem in Release 3.2. 

New Utilities from XENIX System 

The following utilities from Microsoft XENIX System V/386 are included in 
Release 3.2: 

■ clear(l) ~ clears the terminal screen 

■ copy(l) ~ copies multiple files, including directories 

■ csh(l) ~ invokes a shell command interpreter with a C-like syntax 

■ ctags(l) ~ creates a tags file for the vi(l) editor 

■ custom(lM) — installs specific portions of XENIX System packages 

■ fixperm(lM) ~ corrects or initializes XENIX System file permissions and 
ownership 

■ gethz(3C) — returns the frequency of the system clock in ticks per 
second 

■ hd(l) — displays files in hexadecimal format 

■ more(l) ~ views a file one full screen at a time 

■ random(l) ~ generates a random number 

■ settime(l) — changes the access and modification dates of files 

■ strings(l) ~ finds the printable strings in an object file 

■ sulogin(lM) — allows access to single-user mode 

■ tset(l) ~ provides information for setting terminal modes 

■ x286emul(l) ~ emulates XENIX 80286 
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■ xinstall(lM) ~ XENIX System installation shell script 

■ xrestore(lM) ~ invokes XENIX incremental file system restorer 

■ yes(l) ~ repeats "yes" string to prompts 

Release 3.2 Utilities with New XENIX System Support 

The following utilities from Release 3.1 have been modified to include 
XENIX System support in Release 3.2: 

■ ascii(5) ~ reflects addition of decimal table 

■ asy(7) ~ supports XENIX System "exclusive open" capability 

■ cc(l) ~ supports new -Zp option for packing structure members into 
memory 

■ console(l) ~ supports XENIX System compatibility 

■ convert(l) ~ supports conversion of XENIX System archives 

■ core(4) ~ usize parameter has been changed to USIZE 

■ cpp(l) — supports new #pragma pack [1!2!4] option 

■ crash(lM) -- supports XENIX System IFNAM files 

■ cron(lM) — supports XENIX System /etc/default/cron 

■ df(lM) — supports -V option from XENIX System 

■ display (7) ~ supports XENIX System functionality, including ANSI 
escape sequences 

■ echo(l) — supports -n option from XENIX System 

■ egrep(l) — supports -h and -y options from XENIX System 

■ fd(7) ~ supports XENIX System device names 

■ fgrep(l) ~ supports -h and -y options from XENIX System 

■ file(l) ~ supports XENIX System IFNAM binaries, archives, and other 
files 

■ fsck(lM) ~ recognizes files of type IFNAM and allows their recovery 
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■ grep(l) — supports -h and -y options from XENIX System 

■ hd(7) ~ supports XENIX System device names 

■ init(l) ~ supports sulogin utility 

■ ipcs(l) ~ supports new -X option for XENIX System compatibility 

■ keyboard(7) ~ supports XENIX System ioctls 

■ limits(4) — supports XENIX System-specific constants 

■ login(l) ~ reflects changes in password aging and how the tty type is 
set in the environment 

■ Is (1) ~ supports Ic command from XENIX System, and lists XENIX Sys- 
tem shared data and semaphores 

■ mdevice(4) — supports ability to specify halt and poll routines in the 
functional field; also supports ability to share interrupts and DMA 
channels 

■ mount(lM) — supports XENIX file system 

■ mountall(lM) ~ supports XENIX file system 

■ passwd(l) - supports three options (MINWEEK, MAXWEEK, and 
PASSLENGTH) read from /etc/ default /passwd 

■ pwck(lM) — supports XENIX System password information 

■ sdb(l) ~ recognizes IFNAM type files 

■ sdevice(4) — supports ability to share interrupt vectors 

■ sh(l) ~ supports the -n option to echo 

■ stty(l) — supports XENIX System console mode 

■ su(lM) — supports the /etc/ default /su file 

■ sysi86(2) — supports 286 x.out emulation 

■ tar(l) ~ supports XENIX System archives 

■ termio(7) - supports XENIX System lOCTLs 

■ touch(l) ~ merged with the XENIX System settime command 
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AT&T UNIX System V/386 Release 3.2 Base 
System Devices 

The following list defines the contents of the master device file 
(/etc/conf/cf.d/mdevice) before any add-on packages are installed. 





Character 




Device or Software Module 




(block) 


Nodes In 


Controlled By 


Device 


Device 


/dev 


"device driver" 


Name 


Number 


Directory 


(See Note 4) 


asy 


Q 

o 


/dev/tty 


Serial Port (coml, com2) 


rd 


1 (1) 


/dev/'asK/i 


Floppy Disk 


nu 


(0) 


/dev/*dsk/*s* 


Hard UisK 


kd 


5 


/dev/console 


Keyboard 


i„ 
Ip 


7 


/dev/lp' 


Lineprinter (parallel interface) 


mem 


1 


/dev/*mem 


Kernel Memory Driver 


rtc 


Q 
O 


(bee Note 1) 


Keal time Clock 


du 


n 




(bee Note 2) 


Distributed UNIX System (RFS) stubs 


r_« 
tP 


U 


(bee Note 1) 


rloating roint bupport 


cram 




(bee Note 1) 


CMOS RAM (memory) 


gentty 


16 


(See Note 2) 


Generic tty (STREAMS support) 


s52k 





(bee Note 2) 


2K File System Support stubs 


ipc 





(bee Note 1) 


Interprocess Communications 


msg 





(bee Note 1) 


IPC Messages 


sem 


U 


[pee iNote i) 


IPC Semaphores 


shm 





(See Note 1) 


IPC Shared Memory 


sxt 


14 


/dev/sxt* 


Shell Layers 


xt 


13 


/dev/xt* 


Layers (Bit Mapped Terminal) 


prf 


6 


/dev/prf 


Kernel Profiler 


cpyrt 





(See Note 1) 


System Initialization Messages 


vy^eitek 





(See Note 1) 


Numeric Chip Support stubs 


vx 





(See Note 1) 


SimulTask 386 stubs 


osm 


17 


(See Note 3) 


Kernel printout Monitor 


nmi 





(See Note 1) 


Nonmaskable Interrupt (NMI) 








Support 


xsd 





(See Note 1) 


XENIX System Shared Data 
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xsem (See Note 1) XENIX System Semaphores 



Notes: 

1. Nodes are not required for this device driver. See Note 4. 

2. These devices are required to support add-on packages, or are stubs 
(place holders) for add-on device driver packages. The add-on pack- 
ages may install nodes in the /dev directory. 

3. The base system does not have nodes for this device. Nodes can be 
added later via the /etc/mknod command. 

4. Several device drivers are software only drivers. That is, they provide 
a kernel software function packaged as a device that can be added to 
or removed from the system. 
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Differences Between XENIX System and 
Release 3.2 

This section points out some important differences between XENIX 
System V and AT&T UNIX System V/386 Release 3.2 that XENIX System users 
should know and keep in mind. 

Using the ftime() System Call 

Users should stop using the XENIX ftimeO system call, and begin using the 
timeO call provided in Release 3.2. 

Using Shared Data and Semaphore Facilities 

For 286 processes, there are significant differences between the XENIX 
operating system and the UNIX operating system in the positioning of shared 
data and its effect on future memory allocation. For this reason, it is recom- 
mended that XENIX System users discontinue using XENIX System-specific 
shared data and semaphore facilities and begin using the equivalent UNIX Sys- 
tem facilities. 



Understanding Terminal Types 

XENIX System users should note that Release 3.2 supports terminal types 
that were not supported in the XENIX System. For example, terminal type 
AT386-M is the default terminal type for AT&T UNIX System V/386. Use 
this terminal type instead of ansi for all console virtual terminals. The termi- 
nal type at386 should be used with color consoles. 

UNIX System users should be aware that the $TERM environment variable 
can be set automatically, along with the capabilities and attributes associated 
with the terminal type, by using the tset(l) command in the user's .profile and 
by administration of the / etc/ tty type file. For additional information on using 
the tset(l) command and the /etc /tty type file, see tset(l) in the User's /System 
Administrator's Reference Manual. 
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Shutting Down the System 

Release 3.2 does not support the XENIX System haltsys utility. In 
Release 3.2, administrators must use the /etc/shutdown utility to shut the 
system down. 

Using the curses Utility 

The XENIX System curses is "termcap" curses, whereas the Release 3.2 
curses is "terminfo" curses. The terminfo and termcap facilities co-exist in 
Release 3.2. For this reason, the XENIX System (termcap) curses libraries and 
header files have been renamed in AT&T UNIX System V/386 Release 3.2. 
For example, libxcurses is the XENIX System termcap based curses library. 
The corresponding header file is xcurses.h. 

UNIX System to XENIX System Floppy Diskette 
Sharing 

By default, the UNIX System can read data from raw devices in multiples 
of variable size, whereas the XENIX System reads data from raw devices in 
multiples of 512-byte blocks. Therefore, when writing UNIX System media 
that will be read from a XENIX System raw device (such as rfdO, the XENIX 
System primary floppy disk drive), you must specifically set the UNIX System 
write blocking factor to be a multiple of 512 bytes, so the XENIX System raw 
device will recognize the blocksize. 

One way to avoid this problem is to always read from the non-raw forms 
of XENIX System devices, instead of using the raw devices. For example, to 
read a UNIX System tar diskette from a XENIX System primary floppy disk 
drive, specify /dev/fdO on the tar command line, rather than /dev/rfdO. 
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Overview 

These installation notes provide information concerning the installation of 
an AT&T UNIX System V/386 Release 3.2 base system on your computer. 
Instructions are provided for the following conditions: 

■ New Installation 

• How to install AT&T UNIX System V/386 Release 3.2 over an 
AT&T 386 UNIX System V Release 3.1 or 3.1 Update system. 

• How to install AT&T UNIX System V/386 Release 3.2 over an 
already installed AT&T UNIX System V/386 Release 3.2. 

. How to install AT&T UNIX System V/386 Release 3.2 over a 
Non-AT&T UNIX System. (For example, a system with XENIX 
System or MS-DOS installed.) 

• How to install AT&T UNIX System V/386 Release 3.2 on a com- 
puter that has never had an operating system installed. 

■ Non-destructive installation 

• How to upgrade your AT&T 386 UNIX System V Release 3.1 or 
3.1 Update base system software to AT&T UNIX System V/386 
Release 3.2 without destroying any user files or non-Foundation 
Set packages. This is called a non-destructive upgrade installa- 
tion. 

• How to overlay an AT&T UNIX System V/386 Release 3.2 over a 
previously installed AT&T UNIX System V/386 Release 3.2 
without destroying any user files or non-Foundation Set packages. 
This is called a non-destructive overlay installation. 
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New Installation Notes 

There are two ways you may be installing a new AT&T UNIX 
System V/386 Release 3.2. 

■ The AT&T UNIX System V/386 Release 3.2 base system is installed as 
" new " over any previous installed UNIX system. This includes 
AT&T 386 UNIX System V Release 3.1, Release 3.1 Update, or AT&T 
UNIX System V/386 Release 3.2. In this case you should begin with 
the section entitled " Initial Procedure " . 

■ The AT&T UNIX System V/386 Release 3.2 base system is installed as 
the first system installed on your computer or Release 3.2 is installed 
over a non-AT&T UNIX System. In this case you may skip " Initial Pro- 
cedure " and begin with the section entitled " Procedure for New Instal- 
lation " . 

A new installation will destroy all files on the existing system. The Pro- 
cedure For New Installation contains references to the installation procedures 
found in Chapter 2 of the Operations /System Administration Guide. 

Installation of any new add-on packages, is covered in the "Install 
Optional Add-on Packages" section in the Operations /System Administration 
Guide. 



Special Instructions for Upgrade and Overlay 
installations 



NOTE 



If a new installation of AT&T UNIX System V/386 Release 3.2 is to 
be performed, this section may be skipped. 



This section contains precautions and notes relating to a non-destructive 
upgrade or overlay installation. It is divided into three categories: 

■ Non-Destructive installation functionality 
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■ Pre-installation procedures 

■ Post-installation procedures. 

Non-Destructive Installation Functionality 

The non-destructive installation performs the following high-level func- 
tions: 

■ Non-destructive upgrade installation 

. Upgrades from AT&T 386 UNIX System V Release 3.1 (or 
3.1 Update) to AT&T UNIX System V/386 Release 3.2. 

• Does not destroy user data or non-Foundation Set add-on pack- 
ages. 

• Preserves the current disk partitions and file systems. 

• Preserves the current user groups, logins, and passwords. 

• Removes the source files and data files associated with the adm 
command. 

• Requires removal of Foundation Set add-on packages. 

• Requires removal of existing line printer system, existing printers 
and classes, and any jobs in the printer queue. 

• Resets tunable parameters to default values. 

■ Non-destructive overlay installation 

• Overlays an AT&T UNIX System V/386 Release 3.2 over a previ- 
ously installed AT&T UNIX System V/386 Release 3.2. 

• Does not destroy user data or non-Foundation Set add-on pack- 
ages. 

• Preserves the current disk partitions and file systems. 

• Preserves the current user groups, logins, and passwords. 

• Does not require removal of Foundation Set add-on packages. 

• Does not require removal of existing line printer system, existing 
printers and classes, and any jobs in the printer queue. 
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• Resets tunable parameters to default values, 

Pre-lnstallation Procedures 

Before beginning a non-destructive installation, you should perform the 
following procedures: 

■ You will be asked in the procedure if you wish to do a system backup. 
It is recommended that a system backup be done prior to starting the 
installation in case anything goes wrong. Backups of the required files 
can be made from the command line. Chapter 4 of the 

Operations /System Administration Guide provides the details. 

■ Record the current system configuration. This includes the add-on 
software device drivers installed on the system, serial port configura- 
tions, line printer configurations, etc. This information will be used in 
the post-installation procedures. 

■ If you are performing a system upgrade (not an overlay), you will be 
required to remove all Foundation Set add-on packages. It is recom- 
mended to remove these packages prior to starting the installation. 
This will make the installation flow more smoothly. The " Remove 
Add-on Software Package" section in the Operations /System Adminis- 
tration Guide may be used to remove these packages. 

■ To ensure that the system will be properly configured in the post- 
installation procedures, it is recommended that all currently installed 
add-on driver packages be removed before performing a non- 
destructive installation. This is recommended since the installation pro- 
cedure does not rebuild the UNIX System kernel to incorporate currently 
installed software device drivers. Also, the files containing the tunable 
parameters and other system configuration information are overwritten 
with default information. The " Remove Add-on Software Package " 
section in the Operations/System Administration Guide may be used to 
remove these packages. 

Post-Installation Procedures 

After the installation is completed, you will want to return the system to 
it's previous configuration. The following procedures should be followed 
using the system configuration that was recorded in the pre-installation pro- 
cedures. 



20 AT&T UNIX SYSTEM V/386 RELEASE 3.2 



Installation Notes 



■ The software device drivers that were removed prior to installation 
must be installed. The " Install Optional Add-on Packages " section in 
the Operations /System Administration Guide may be used to install these 
packages. 

■ The AT&T UNIX System V/386 Release 3.2 equivalents of the Founda- 
tion Set add-on packages that were removed prior to an upgrade instal- 
lation should be installed. The " Install Optional Add-on Packages " 
section in the Operations /System Administration Guide may be used to 
install these packages. 

■ Configure the line printer subsystem, second serial ports, etc. Confi- 
guration changes can be made to the required files from the command 
line. Chapter 4 of the Operations /System Administration Guide provides 
the details. 
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initial Procedure 

1. If you have either AT&T 386 UNIX System V Release 3.1 (or 3.1 
Update) or AT&T UNIX System V/386 Release 3.2, perform the pro- 
cedures starting at the beginning of Chapter 2 of the 
Operations/System Administration Guide through Step 5 in the section 
" Boot System to Single User Mode " . 

2. You will receive the following message: 


Is this a new installation or a release upgrade to your 
existing system? (Strike "n" (new) or "u" (upgrade) 
followed by ENTER). 



3. If you enter n, use the "Procedure for New Installation" in this docu- 
ment. 

4. If you enter u, use the "Procedure For Installing Upgrade" in this 
document. 
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Procedure for New Installation 



NOTE ^^^^ procedure assumes you have made the n response to Step 2 in 
the Initial Procedure. 

I or 

The AT&T UNIX System V/386 Release 3.2 base system is installed 
as the first system installed on your computer or Release 3.2 is 
installed over a non-AT&T UNIX System. In this case, perform the 
procedures starting at the beginning of Chapter 2 of the 
Operations /System Administration Guide through Step 5 in the section 
" Boot System to Single User Mode " and return to Step 1 of this pro- 
cedure. 

or 

You struck ENTER in Step 2 of the Procedure for Installing Upgrade, 

1. You will receive the following message: 


WARNING: A new installation of the UNIX System will destroy 

all files currently on the system. Do you wish to continue (y or n)? 

To continue type y and proceed to Chapter 2 of the Operations /System 
Administration Guide. Perform the "Partition the Hard Disk" pro- 
cedure. 

If you type n, you will be placed at the single-user shell prompt. 

If you wish to start this procedure over and not reboot the sys- 
tem, type: 

INSTALL 

If you wish to start the procedure again and reboot the system: 
a. Type: 

uadmin 2 
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b. Boot the system off the floppy by striking [ctrl] , {alt) , 
and (del) simultaneously. 

c. Start the installation process again by returning to the 
" Initial Procedure " section in this document. 

2. If you type y, you will then receive the following message: 



A surface analysis will now be done. 

This will destroy all data on the hard disk. 

Strike ENTER to continue or DEL to abort. 



If you wish to continue, strike [enter] . 

If you type (del), you will be placed at the single-user shell prompt. 

If you wish to start this procedure over and not reboot the system, 
type: 

INSTALL 

If you wish to start the procedure again and reboot the system: 

a. Type: 
uadmin 2 

b. Boot the system off the floppy by striking [ctrl] , (alt), and 



DEL I simultaneously. 



c. Start the installation process again by returning to the " Initial 
Procedure" section in this document. 



3. If you strike [enter] , you will see the following message: 



UNIX System file systein(s) will now be created on the hard disk 



4. Go to Step 10 in the section "Create UNIX System File Systems" in 
Chapter 2 of the Operations /System Administration Guide and complete 
the procedure for installing a base system on your computer. 
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Procedure for Installing Upgrade 




This procedure assumes you have made the u response to Step 2 in 
the initial procedure. 



1. A sanity check of the file systems will be done to determine if there is 
any uncorrectable file system damage that cannot be upgraded. If 
there is, an upgrade installation cannot be performed. 



The following screen may be ignored if a system backup was 
performed prior to starting this installation. You may con- 
tinue by striking ENTER. 



If the sanity check determines that there is no file systems damage, 
you will receive the following message: 



WARNING: A system backup is suggested prior to doing a 
system upgrade. To ensure a correctly functioning system, 
various add-on packages supplied with the foundation set 
will need to be removed. Also, if any packages are 
installed that reconfigure the UNIX System kernel, they 
should be removed before proceeding with the new installation, 
To proceed with the installation strike ENTER, otherwise, 
strike DEL to abort. 



To continue with an upgrade installation, strike [enter] . 

To abort the installation procedure, strike (del). You will then be 
given the single-user shell prompt. Do the following: 

a. Type: 

uadmin 2 
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b. Remove the floppy from the disk drive. 

c. Boot the system off the hard disk by striking [ctrl| , [alt] , 
and (del) simultaneously. 

d. Back up your files [use face menus or use the command level 
(refer to Chapter 4 in the Operations /System Administration 
Guide)]. 

e. Shutdown the system. 

f. Reinsert the flop py and boot off the floppy by striking [ctrl] , 
[alt] , and [del) simultaneously. 

g. Start the installation process again by returning to the " Initial 
Procedure" section in this document. 

2. If the sanity check determines that there is file system damage, you 
will receive the following message: 



You will be unable to do an upgrade because your system 

does not contain a valid UNIX System. Please consult your 

"Release Notes" for further information. 

Strike ENTER to continue with a new installation 

or DEL to abort the installation procedure. 



To continue strike [enter] . You will perform a new installation pro- 
cedure. Go to the Procedure for New Installation. 



To abort the installation procedure, strike [del] . You will then be 
given the single-user shell prompt. You may not be able to reboot the 
system. If you wish to start this procedure over without a reboot, 
type: 



INSTALL 



If you strike [enter] in Step 1, the root (/) file system will be checked 



to make sure that there is enough space for the files to be saved. Ten 
free blocks are needed. If there is not enough space, you will receive 
the following message: 
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There is not enough space in the root filesystem on your hard disk 
to back up files for a system upgrade. Please remove some files and 
try again. Consult your "Release Notes" for further information. 



If there is not enough space, you will be given the single-user shell 
prompt. Do the following: 

a. Type: 

uadmin 2 

b. Remove the floppy from the disk drive. 

c. Boot the system off the hard disk by striking [ctrl] , [alt) , 
and [del] simultaneously. 

d. When the system comes up, remove enough root files to free 
10 blocks. If you have created any files under /, consider 
these for removal. 

Shut down the system. 

Rein sert th e flop py and boot off the floppy by striking (ctrl). 



ALT 



and 



etiop 
(del) 



simultaneously. 



Start the installation process again by returning to the " Initial 
Procedure" section in this document. 



If you are upgrading from Release 3.1 or 3.1 Update and if any Foun- 
dation Set add-on packages are installed, you will receive a message 
similar to the following: 




If your Foundation Set add-on packages were removed prior 
to starting this procedure, the following screen will not be 
seen. 
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You may have different packages installed from those shown 
in the following screen. 



To ensure full UNIX System V/386 Release 3.2 functionality, 
the following operating system packages must be removed, 
and the Release 3.2 equivalents installed after the upgrade; 



Editing Package Version 1.0 

2 Kilobyte File System Utility Package Version 1.0 
Security Administration Package 



If not removed prior to the start of installation, you must remove all 
installed Foundation Set add-on packages before proceeding to ensure 
full Release 3.2 functionality. If you do not remove these packages all 
at once, the next time you select u to upgrade your system, you will 
receive the same message with the current packages to be removed. 

If you are running Release 3.2, and doing the overlay upgrade, you 
will not be required to remove the Foundation Set add-on packages. 

If any of these packages are installed, you will be put in single-user 
shell prompt. 

a. Type: 

uadmin 2 

b. Remove the floppy from the disk drive. 

c. Boot the system off the hard disk by striking [ctrl) , [alt]. 



and del] simultaneously. 



When the system comes up, execute " removepkg " as covered 
in " Remove Add-on Software Package " in Chapter 2 of the 
Operations/System Administration Guide to remove the listed 
packages. 
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e. Shutdown the system. 

f. Rein sert th e flop py and boot off the floppy by striking [ctrl] , 
(alt), and |del) simultaneously. 

g. Start the installation process again by returning to the " Initial 
Procedure" section in this document. 



The packages that are discussed below should have been 
backed up as discussed in the pre-installation procedures. 



5. If all the Foundation Set add-on packages are removed, but there are 
still some other packages installed (e.g., Crystal-Writer and STARLAN 
Network), you will receive the following message: 



WARNING: If any of the packages currently on the system fail to 
work after the upgrade, remove the package and then re-install it. 



6. If the Release 3.1 Line Printer (LP) System is on your machine, you 
will receive the following message: 



The 3.1 LP system exists on this machine. 
This installation will remove the following: 

Existing LP System 

Existing Printers and Classes 

Any Jobs in the Printer queues 

Strike ENTER to continue or DEL to abort 



If you wish to preserve your LP files, strike [del] . You will then be 
put in single-user shell prompt. 
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a. Type: 

uadmin 2 

b. Remove the floppy from the disk drive. 

c. Boot the system off the hard disk by striking [ctrl) , [alt), 
and (del) simultaneously. 

d. Backup or save the LP files required. 

e. Reinsert the flop py and boot off the floppy by striking |ctrl] . 



Keinsert tnetioppy ana Doot ori 
(alt, and del] simultaneously. 



f. Start the installation process again by returning to the " Initial 
Procedure " section in this document. 

7. A UNIX System will be installed on the hard disk. You will see the 
following message: 



A UNIX System will now be installed on your hard disk 



8. After a delay you will see the following message: 



Please standby 

When you are prompted to reboot your system, 
remove the floppy disk from the diskette drive, 
and strike CTRL-ALT-DEL. 
Please wait for the prompt. 



9. Your prompt to reboot will appear as follows: 
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c 

Reboot the system now. 



10. To install the remainder of the base system, perform the procedures in 
the section " Install the Remainder of the Base System " in Chapter 2 
of the Operations/System Administration Guide. 

11. Configure your system as instructed in the sections " Pre-Installation 
Procedures " and " Post-Installation Procedures " . 



RELEASE NOTES 31 



Overview of Basic Procedures 

The following sections provide brief descriptions of some basic UNIX Sys- 
tem procedures. 

Booting the System 

The following list of instructions will boot an AT&T UNIX System V/386 
Release 3.2 system after the Base System has been installed. Apply power to 
the system and wait 1 or 2 minutes; the second-stage boot should be loaded 
automatically by the PROMs. 

The boot program will load and give you the following message: 

Booting UNIX System . . . 

If you immediately press ANY key, the boot process will be interrupted 
and the following message will be displayed: 

Enter name of a kernel to boot: 

If you enter the name of a kernel to boot, the boot process will continue. 
If you do not enter anything, after 1 minute /u nix w ill boot automatically; if 
you want to boot /unix immediately, press the [Enter) key. 

Shutting Down the System 

The following steps are necessary to shut down an AT&T UNIX 
System V/386 Release 3.2 computer properly: 

1 . Log in as root and change your directory to /. . Note that you must 
be on the console (/dev/console). 

2. Run the shutdown program with the following options: 

shutdown -y -gTIME 

where TIME is the number of seconds to be allotted before the system 
is actually halted. A time factor of at least 120 seconds (2 minutes) is 
recommended for your systems that are being used as multi-user sites. 
The time factor allows you to exit editors and save programs before 
the system goes down. 
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The system will proceed to shut itself down after the allotted time, and 
when the message 

Reboot the system now 



Ctrl 



[Alt] Delete] key Combination 



appears, the system can be turned off. The 
can be pressed, or the system can be turned off and then turned on again in 
order to reboot at this point. 



Instructions for Updating Selected Files from 
tiie Release 

If necessary, selected files may be extracted from the installation diskettes. 
Appendix A contains a list of all the files on the Foundation Set diskettes. All 
the installation diskettes, with the exception of diskette 1 of 7 of the Base Sys- 
tem and diskette 1 of 1 of the Remote Terminal Package, are cpio diskettes. 
Diskette 1 of 7 of the Base System and diskette 1 of 1 of the Remote Terminal 
Package are mountable file systems. If the file that you want to extract is on a 
cpio diskette, you should insert the diskette into the floppy diskette drive and 
use the following command to extract the selected file: 

cpio -icBvd filename < /dev/dsk/fO 

If the file you want to extract is on a mountable file system diskette, you 
should insert the diskette into the floppy diskette drive and use the following 
commands to extract the selected file: 

/etc/mount -r /dev/dsk/fO /mnt 
cp /mnt /<filename> <newfile> 
/etc/umount /dev/dsk/fO 
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The following sections provide reminders and general systenn trou- 
bleshooting information. 

Converting to getopts by Hand 

getoptcvt [see getopts(l)] adds about 30 lines of code to a shell script, so 
you may want to convert scripts by hand instead. Converting by hand prob- 
ably will make the code cleaner and easier to understand. Also, you do not 
have to worry about parsing option-arguments that are also options. 

Follow these guidelines to convert most scripts that currently use the 
getopt(l) command. 

Step 1 Delete the old invocation line and the if statement that checks the 
exit code. 

Step 2 Change the for loop to a while loop that invokes getopt(l). 

Step 3 Change the patterns in the case statement from -option to single 
option letters. 

Step 4 Delete the case for — . 

Step 5 Add a case for '1'. This case may be used to print the usage mes- 
sage and to exit with a non-zero exit code. Note that the ? is 
quoted since it is interpreted for filename expansion. 

Step 6 Remove all shift commands within the case statement. 

Step 7 Change $ 2 to $ OPTARG for cases that require an option argu- 
ment. 

Step 8 Add the statement shift 'expr $OPTIND - 1* after the while loop 
so the remaining arguments can be referenced as before. Following 
is an example of a script before and after conversion. 
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( 

# before conversion 
set -- 'getopt abo ; $*' 
if [ $? != ] 
then 

echo $USAGE 
exit 2 

f i 

for i in $* 
do 

case $i in 

-a I -b) FLAG=$i; shift;; 

-o) OARG=$2; shift 2;; 

--) shift; break;; 

esac 

done 



/ ' 

# after conversion 
while getopts abo: i 
do 

case $i in 
a I b ) FLAG=$i ; ; 
o ) OARG=$OPTARG; ; 

?) echo $USAGE 

exit 2 ; ; 

esac 

done 

shift • expr $OPTIND - 1 ' 
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If you want your script to be compatible with earlier UNIX systems (that is, 
use either getopts or getopt), convert it as the following example shows: 



if [ "$OPTIND" = 1 ] 
then 

while getopts abo : i 
do 

case $i in 
a I b) FLAG=$i ; ; 
o) OARG=$OPTARG; ; 

?) echo $USAGE 

exit 2 ; ; 

esac 

done 

shift ' expr $OPTIND - 1' 
echo $* 



else 



f i 



set -- 'getopt abo: $*' 

if [ $? != ] 

then 

echo $USAGE 
exit 2 

f i 

for i in $* 
do 

case $i in 

-a I -b) FLAG=$i; shift;; 

-o) 0ARG=$2; shift 2;; 

--) shift; break;; 

esac 

done 
echo $* 
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edit, ex, vedit, vi, view 

The edit, ex, vedit, vi, and view commands allow separate .exrc files in 
any directory. In addition, if you change directory to another user's directory 
and use any of these editors to edit a file in that other user's directory, the 
editor will execute the .exrc file if it exists in the second user's directory. This 
functionality has security implications depending on the contents of the .exrc 
file, because the commands are executed as the user invoking the editor and 
not as the person who owns the .exrc file. 

In this release a new option has been added to the vi/ex commands to 
allow you the option of reading the .exrc file in the current directory. Ini- 
tially, the flag is NOT set. That is, the vi/ex command will NOT read the 
.exrc file if it exists in the current working directory. You can modify this 
option by inserting the line 

set exrc 

or the abbreviation 

set ex 

in the $HOME/.exrc file which is read when one of these editors is executed 
if the EXINIT variable is not set in the .profile. If you want to set the 
EXINIT variable, add the following lines to your .profile: 

EXINIT="set exrc" 
export EXINIT 

However, you should note that executing vi/ex as another user with su could 
result in your files being compromised, since certain variables in the environ- 
ment are passed when su is executed without the " - " . 

For more information, see the ex(l) manual page in the User's /System 
Administrator's Reference Manual. 
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Floating Point Emulation 

Two floating point emulators are provided in the product. The default 
emulator, called /etc/ emulator. dflt, is linked to / etc / emulator and provides 
better performance than the second emulator, kept in / etc / emulator. r ell . 
However, /etc /emulator. dflt does NOT emulate all the instructions of the 
80387 processor, specifically the following: 



FCOS 


cosine function (80387 only) 


FDECSTP 


decrement stack pointer 


FINCSTP 


increment stack pointer 


FPREMl 


partial remainder (80387 only) 


FRSTOR 


restore saved state 


FSAVE 


save state 


FSETPM 


set protected mode 


FSIN 


only sine function (80387 only) 


FSINCOS 


sine & cosine function (80387 only) 


FUCOM 


unordered comparison (80387 only) 


FUCOMP 


unordered comparison and pop (80387 only) 


FUCOMPP 


unordered comparison and double pop (80387 only) 



The second emulator, / etc / emulator.rell , provides complete emulation of 
the 80387 instruction set. However, this emulator has less performance than 
the default emulator. This second emulator should be used if problems occur 
with UNIX System 286 applications. The problems will manifest themselves 
by the application core dumping with a floating point exception. 

If you need to change from the /etc /emulator. dflt emulator to the 
/etc /emulator.rell emulator, log in as root and type the following command: 

In /etc/emulator.rell /etc/emulator 

Similarly, if you need to change from the /etc/emulator.rell floating point 
emulator to / etc / emulator. dflt , log in as root and type the following command: 

In /etc/emulator.dflt /etc/emulator 

After you relink the proper emulator, the machine must be rebooted for 
the system to start using the other emulator. 
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Floppy Disk Operations 

The following enhancements have been made to the floppy disk subsys- 
tem for AT&T UNIX System V/386 Release 3.2: 

■ Enhanced 3.5 inch floppy disk support now allows the operating sys- 
tem to access a 3.5 inch diskette drive as either diskette or diskette 1. 
In the previous release, the 3.5 inch floppy drive could be accessed only 
as diskette 1. 

■ Automatic format detection of floppy diskettes allows access to floppies 
using generic device names regardless of the format of the diskette 
inserted into the drive. The following nodes have been added to the 
system to support this enhancement: 

/dev/(r)dsk/fO 
/dev/(r)dsk/fOt 
/dev/(r)dsk/fl 
/dev/(r)dsk/flt 

For example, if drive is a 5.25 inch floppy drive and you want to 
create a cpio file on a 1.2Mb diskette, you would insert a formated 
1.2Mb floppy diskette into the drive and type the following command: 

find . -print I cpio -ocv > /dev/rdsk/fOt 

Similarly, you can insert a formated 360 Kb diskette into the drive and 
issue the same command. The system will automatically detect that a 
formatted 360 Kb diskette is in the drive and process the command 
appropriately. 

The following list describes important reminders and troubleshooting 
information for floppy disk operations: 

■ Some error messages from floppy operations appear only at the con- 
sole, regardless of which terminal invoked the floppy command from 
which the error originated. This is true for all errors detected and 
displayed by the device drivers. 

■ Sometimes reading from a 360 Kb disk drive may fail and it will appear 
as though the floppy disk drive door is not closed. If this should occur, 
reinsert the floppy disk and close the drive door. 
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■ On some 80386 computers, the system will not recognize that the 
floppy disk drive door is open if the floppy disk is completely inserted 
into the disk drive and the door is left open. To correct this, make sure 
that the floppy drive door is always closed when a floppy disk is com- 
pletely inserted. 

Kernel Operations 

The following list describes important reminders and troubleshooting 
information for performing kernel procedures: 

■ The process accounting computation of a process's memory usage is 
incorrectly maintained. The value calculated for process memory usage 
is slightly less than the real result. 

■ When a program executes integer division by zero, the following error 
message is displayed: 

floating exception - core dumped 

This message does not accurately describe the error. 

■ Processes spawned by the kernel at boot time (sched, /etc/init, vhand, 
bdflush) have start times (STIME), that is the time the system was last 
brought down, not the time they were spawned. 

■ Some core dumps may have possible file size errors reported by fsck, 
but these are only warnings and can be ignored. To determine whether 
the possible file size errors reported are resulting from core dumps, exe- 
cute: ncheck -i i-number where i-number is given in the fsck message: 

POSSIBLE FILE SIZE ERROR l = i-number 

ncheck will generate the path name of a file from its inode number, i- 
number. 

■ If the operating system runs out of free clists, all input/output activity 
from/to terminal ports and the console will cease. No warning mes- 
sage is printed by the system to show that it is out of clists. 

■ The value of the SHMALL tunable parameter specifies the maximum 
number of in-use shared memory segments allowable systemwide. This 
parameter is not checked by the system [that is, shmget(2) does not 
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check this limit]. 



login 

To discourage intruders, the encrypted password and password aging 
information formerly found in /etc/passwd has been moved to /etc /shadow. 
This file can be read only by the superuser. You will still be able to change 
their passwords using the passwd(l) command. Password and aging informa- 
tion is added to /etc/shadow by running a new program, pwconv(lM). This 
program can be executed only by the superuser. 

If you have an application or program that writes password and /or aging 
information into /etc/passwd, the program will have to be modified so that 
pwconv(lM) is executed after the information is appended to /etc/passwd. 
Until the modification can be made, the administrator with superuser privilege 
will have to run the program before the user who has been added or whose 
password information has been modified can log in. 

To set a variable in an /etc /default file, the name of the variable is fol- 
lowed by an " = " and the value of the variable, with no embedded spaces or 
tabs. In /etc /default /login, the following variables may be set: 

CONSOLE If set, only the superuser may login on the terminal defined 

as the console. For example, 

CONSOLE= /dev/console 

means that only root may login on the console. If CON- 
SOLE is not in /etc /default /login, the superuser may login 
on any terminal. 

ALTSHELL If set to YES, the SHELL environment variable will be set to 
the users shell, if that shell is not /bin/sh. If set to NO, the 
names of nonstandard shells will not be put in the SHELL 
environment variable. The default value for this variable is 
NO. 

PASSREQ If set to YES, all users must have have a password. Any 

user without a password will be asked for one at the first 
opportunity permitted by the password aging set for that 
user (i.e., users without passwords may not change their 
NULL passwords if password aging is enabled for them, and 
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the minimum time before a password can be changed has 
not elapsed). 

TIMEZONE This variable sets the TZ variable in the environment of the 
user. It must match the timezone set in /etc /TIMEZONE. 

HZ This variable sets the environment HZ, the rate of the sys- 

tem clock, for the user logging in. 

PATH This variable sets a default path for a user who does not 

have uid 0. 

SUPATH This variable sets the default path for the superuser logging 

in. Another default path for the superuser is in 
/ etc/ default /su, which is set for superusers who did not 
login as such, 

ULIMIT This variable sets the maximum file size for a user. It is in 

units of 512-byte blocks. 

TIMEOUT This variable is the length of time which " login " will wait 

for a password after receiving a user name. It is in units of 
seconds. 

UMASK This variable is the default umask for users. 

IDLEWEEKS This variable is the number of weeks which an account may 
remain idle before its login is disabled. 



passwd 

The /etc /default /passwd file has the following variables which may be set: 

PASSLENGTH This variable is the minimum length of a password. Any 
password shorter than this length will be disallowed. The 
default length, if the variable is not set in the defaults file, is 
6. 

MINWEEKS This variable is the number of weeks, after changing a 

passsword, during which the password may not be changed 
again. 
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MAXWEEKS This variable is the number of weeks, after changing a pass- 
word, after which you will be requested to change your 
password when you next log on. 

The MINWEEKS and MAXWEEKS variables may be overridden with the 
passwd program, by explicitly setting password aging for a particular user. 

Changing the ULIMIT Parameter 

In AT&T 386 UNIX System V Release 3.1, the default ulimit is a tunable 
parameter settable via ID/TP in the operating system. If an administrator 
wanted larger values for the users of the system, the ID/TP ulimit value 
would be changed by the administrator to reflect the new value. The system 
would then need to be rebooted before the new default value went into effect. 

In AT&T UNIX System V/386 Release 3.2, it is possible to override the 
ulimit set in the operating system by setting the ULIMIT parameter in 
/etc /default /login. The current /etc /default /login sets the ULIMIT parameter 
to 4096. If an administrator wishes to change the default ulimit, both the 
ID/TP value and the /etc /default /login value would need to be changed to 
reflect the new value. 



Longest Allowed Path Names 

The longest path name is restricted to 1024 bytes. System calls that 
require path names as arguments will now fail, setting errno to ENOENT, if a 
longer path name is given. 

Previously, the path name was not restricted by the UNIX operating sys- 
tem; however, most programs gave an ad hoc limit to the length. Generally, 
these limits were well below 1024 bytes, so most programs should not be 
affected by this change. 

The limits.h file defines a macro PATH_MAX to be the longest length of 
a path name. In Release 3.1 this file incorrectly sets the macro to 256, but it 
will probably be changed in a future release to 1024. Local system adminis- 
trators can safely change the value for PATH_MAX to 1024 without harm, 
since the Release 3.1 system internally uses the longer limit. 
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You are encouraged to include the limits.h file with a statement like 
#include <liniits.h> 
and to refer to the PATH_MAX macro for the longest path name allowed. 



Saving Device Files When Bacicing Up root File 
System 



When you back up the root (/) file system using the backup(lM) com- 
mand, the device files {/dev directory) are not saved as part of the backup. To 
save the device files, become the superuser, mount a blank formatted floppy 
that has a file system on it, and enter the following commands: 

# mount /dev/... /mnt 

# find /dev -print I epic -pdl /mnt 

where /mnt is the directory on which the floppy disk file system is mounted. 
The epic options are lowercase letters p, d, and 1. 

To restore the files, insert the floppy on which the files were saved, and 
enter the following commands: 



# 



/etc/mount /dev/dsk/fO /mnt 



# 
# 



cd /mnt 

find . -print I epic -pdl /dev 



# 



/etc/umount /dev/dsk/f0ql5d 
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Shell Scripts 

It is strongly recommended that all applications convert any shell scripts 
into binary programs if specific user (group) permissions are required in the 
shell script command lines. To pass permissions, the binary program must 
have the setuid (gid) mode bit on and the owner (group) of the binary pro- 
gram set to the ID required. Then the exec(2) system call can be invoked with 
the binary program as the argument and the correct permissions will be 
passed. 

If it is not possible to convert the shell scripts into binary programs, then a 
binary interface program must be written that would have the setuid mode bit 
on and the owner of the file set to root. Next, the process would have to do a 
setuid (gid) system call internally with the uid (gid) that must be passed to a 
sub-shell. This is only possible because the setuid (setgid) system call sets 
both the real and effective uid (gid) when called by a process with the effec- 
tive uid of root. Finally, the binary interface would then call the shell script. 
This is a potentially dangerous procedure unless the programmer is aware of 
all the implications. 

invoking Bourne Shell Scripts from CSH 

A single line comprised of a colon (:) should be added as the first line of 
Bourne Shell scripts when these scripts are to be invoked from csh(l). This 
will cause csh(l) to recognize the script as a Bourne Shell Script and execute it 
appropriately. 
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This section describes problems that may occur with Release 3.2, and in 
some cases, workarounds to those problems. 

mknod(IM) 

The usage message for the mknod(lM) command is incorrect. It does not 
agree with the documentation since it does not display the p option for creat- 
ing named pipes. The User's /System Administrator's Reference Manual manual 
page for mknod(lM) correctly documents the usage. mknod(lM). 

layers(l) 

XENIX termcap-based applications, such as SCO Professional, does not 
work properly under the UNIX System xt-layers. The problem is when 
TERM=630 or 5620 is declared, the size of the screen is defined at 70 lines. 
When xt-layers is invoked, and windows of a smaller size are created, SCO 
Professional still thinks that is dealing with a full screen. Since the screen is 
not 80 characters wide, double lines are created. 

Workaround: The problem is that SCO Professional applications look in 
/etc/termcap directly for the value of the lines and columns. Therefore, it 
does not paint the screen correctly when a window with fewer lines and 
columns is created. 

In order to have a /etc/termcap entry work on a terminal that has layers 
invoked, you will have to create a new entry in the /etc/termcap file. To 
create the new termcap description, edit the /etc/termcap file and search for 
the terminal name that you want to use with layers. The first line of a 
termcap entry begins in column one, the actual terminal description follows. 
The lines that describe that terminal start with a <TAB> and end with a 
backslash (\). Copy that termcap definition up to the beginning of the next 
terminal description. The following procedure will accomplish this goal. 

1 . Change the name that you would set your TERM to. 

EXAMPLE: 

for 5620/dmd terminal, change the following line from: 

att5 62 I ATT5 62 | dmd | tty5 62 | ttydmd |5620|5620 
terminal 88 columns @(#)5620.ti 1.1: 
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to: 

att5 620-s I ATT5 620-S | dmd-s | tty5620-s | ttydmd- 

s I 5620-s I 5620 terminal < 88 columns @(#)5620.ti 

1.1: 

This allows you to set your TERM to " dmd-1 " which is used in this 
example to specify a dmd invoked with layers, 

2. Modify the variables for lines "li" and columns "co". Search for the 
line that has the lines and columns defined. It will look similar to: 

; co#88 : li#70 : kn#4 : 

In this example, change the " 88 " to the number of columns you 
predict will be in your average size window. Also, change the number 
of lines from " 70 " to what you would expect them to be. 

3. Using "dmd-s" as an example, set your TERM to the name you gave 
your new termcap definition before invoking the SCO application. 
However, this TERM name is not recognized by curses applications 
(i.e., vi, ed, etc). You will be able to set your TERM to one type if you 
link /usr/lib/terminfo/d/dmd to / usr/ lib /terminfo/d/ dmd-s. 



ps(1) 

In AT&T 386 UNIX System V Release 3.1, the usage of ps changed. The 
ps command now checks and sets the user's effective UID to the real UID and 
the effective GID to the real GID. Therefore, only users with a real user id of 
root or a real group id of sys will be able to use the -1 options to ps. 

/etc/sulogin(1 M) 

/etc/sulogin(lM) is intended to be invoked by init when the root user 
invokes init to enter single user mode. This command should never be 
invoked directly from the command line. 

When invoked by the root from the command line, /etc/sulogin will 
invoke a second shell for the root user but will not place the system in 
maintenance mode. 
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When /etc/sulogin is run by a normal user from the command Hne, the 
following error message is printed: 

**** NO ENTRY FOR root IN SHADOW FILE! **** 
Entering system maintenance mode " . 

This command does nothing except display the error message which 
should be ignored. 

System Startup 

If /tmp is a separate mount point, then /tmp is never cleaned up when a 
reboot occurs. This may lead to wasted disk space. This change is only 
necessary if the machine is configured with the tmp file systems {/tmp and 
/usr/tmp) on separate file systems. 

Workaround: The following modification should be made to the 
/etc/init.d/RMTMPFILES file by root. 

■ If /tmp is a separate file system, add the following two lines after the 
chown sys /tmp line: 

else 

rm -rf /tmp/* 

■ If /usr/ tmp is a separate file system, add the following two lines after 
the chown sys /usr/tmp line: 

else 

rm -rf /usr/tmp/* 



kernel 

The kernel will not rebuild properly if " weitek " is turned off in 
/etc/conf/cf.d/sdevice. If you try to rebuild the kernel using the idbuild(lM) 
command, the build will fail with the following symbols undefined: 

gets 7 

weitek_intr 
weitek_reg 
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Workaround: Edit /etc/conf/cf.d/sdevice and search for "weitek". 
Change the second field on the line from " N " to " Y " . Write the file and quit 
the editor. Then rebuild the kernel using the /etc/conf/bin/idbuild(lM) 
command. This will turn Weitek back on. 

If it is absolutely necessary to turn off Weitek, these lines must be added 
to the / etc / conf /pack.d/ weitek/ stuhs.c file. Immediately after the line 

/* Weitek stubs */ 

add the following lines: 

int gets? ( ) { } 

weitek_intr ( ) {} 

char *weitek_reg = (char *)0; 



Installation and backup(IM) 

A complete or partial system backup(lM) will back up Foundation Set 
add-on packages in addition to the user files. This is not a serious problem, 
but may result in a new package being overwritten by an older version if a 
complete restore is done. The new package would then have to be reinstalled. 
It also causes the backup to take more time and to use more media than sim- 
ply backing up user files. 

Workaround: If a complete restore is to be done, it should be done 
immediately after the Base System is installed, and before any of the Founda- 
tion Set add-on packages are installed. It may be necessary to use 
removepkg(]M) to remove an old package before the new version can be 
installed. 

If a selective restore is done, and if only user files are to be restored, the 
order of installation is not important. However, it is still advisable that the 
restore be done before add-on packages are installed. 
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backup(IM) and restore(IM) 

If you are doing a complete restore of a backup, it is not advisable to use 
the overwrite option since old versions of files may overwrite new versions. If 
you want to overwrite, do a selective restore so that you know exactly which 
files are to be overwritten. 

If, when doing a complete or partial backup, the number of floppies 
needed appear to be unnecessarily large, press " delete " and remove the files 
/etc/.lastbackup and /etc/.lastpartial. A complete backup should be started. 

Enhanced EGA Support 

Some video boards do not work correctly. The Zenith/Heath 
" Enhanced " EGA is an example of such a board not supported by the operat- 
ing system. 

Application Installation 

The normal XENIX SGS is not present. Installation procedures that call the 
XENIX System language tools directly must be modified to use the UNIX Sys- 
tem tools. Application installation procedures that must use the XENIX System 
linkage editor to link pre-existing object modules will not work. 

System Startup (/etc/rc files) 

There is no longer a single /etc/rc file. Installation procedures that 
attempt to modify /etc/rc or /etc/rc.local must be modified to alter the 
appropriate rc file for the appropriate run level. 

Uid for bin 

The numeric uid for the user bin, and the numeric gid for the group bin, 
have changed. Installation scripts which depend on the old values must be 
changed to accept the new values. The values for the XENIX System were 3 
and 3; the values are now 2 and 2. 
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Is(1) 

The UNIX System command Is and the XENIX System command Is differ 
in the meaning of the size of a file in blocks (as provided by the -s option). 
The XENIX System understands that all filesystems have a block size of 1024 
bytes, and thus correctly calculates the number of direct and indirect blocks. 
The UNIX System assumes a 512-byte block size when making the calculation. 

passwcl(l) 

For enhanced security, encrypted passwords have been moved out of the 
file /etc/passwd. Installation procedures that examine or modify the password 
file directly must be modified to use the new scheme. Under the new scheme, 
user passwords and aging information are stored in /etc /shadow. Refer to 
Chapter 5 of the Operations /System Administrator's Guide for more informa- 
tion. 



uname(l) 

The default settings for the fields of the uname structure are different. 
This will result in different output for the -m and -s options of the uname 
command. Installation procedures that use the output of the uname com- 
mand to determine machine type or system type must be modified to handle 
the new output correctly. Under the XENIX System, the " sys " entry defaults 
to "XENIX", and the "cpu" field defaults to "iAPX386". Under the UNIX 
System, the respective entries default to "unix" and "1386". Under both 
XENIX System and UNIX System, the remaining entries have release-dependent 
defaults. 
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Differences in Support of XENIX-286 
Execution 

XENIX-286 Emulation 

Support of XENIX-286 executables is now handled by a user-level emula- 
tor, rather than by the kernel. As a result, attempts to execute a text file that 
is open for writing (which fail with the error ETXTBSY under the XENIX Sys- 
tem) will succeed, and the emulator will then refuse to run the executable. 

init(IM) 

The shell that is provided when the user puts the system in single-user 
mode (via "init" s) has a useless path. Immediately after entering single-user 
mode, the shell search path should be set to whatever the user wants. 

mountall(IM) 

The documentation for the mountall command states that the command 
can take a list of files (or "-" for stdin) as command line arguments. This is 
not true. The mountall command ignores its arguments, and always reads the 
file / etc /f stab. 

nlsaclmin(IM) 

In the Operations /Systems Administration Guide, the RFS chapter states that 
to start the Starlan listener, the command is: 

nlsadmin -S starlan 

The correct command is: 

nlsadmin -s starlan 

uname(l) 

In the Operations /Systems Administration Guide, the RFS chapter states that 
typing the command 

uname -S nodename 

will result in the user being prompted for the new name. In fact, the system's 
name is set to nodename. 



52 AT&T UNIX SYSTEM V/386 RELEASE 3.2 



Future Directions 



awk, nawk, oawk 

With Release 3.1 there is a new awk (nawk). For this release awk is 
linked to oawk and is the default when you type awk. In the next major 
release of UNIX System V, nawk will be the default and will be linked to awk, 
but oawk will still be available. 



nawk must be used with the international version of the software. 



getdents(2) 

The implementation of getdents(2) does not match the description in the 
dirent(4) manual page. The field d_of£ in struct dirent does not contain the 
file offset of the current directory entry, but rather the file offset of the follow- 
ing entry. This will be corrected in the next major UNIX System V release. 
The correction may require the re-compilation or re-linking of programs using 
the directory-management library routines described in directory(3X) (open- 
dir, closedir, readdir, telldir, seekdir, rewinddir) and may require source 
changes to programs using the getdents{2) system call directly. 



Regular Expressions 

In Release 3.1 the implementation of regular expressions (for example in 
ex, egrep, regexp.h, and sh) has been extended to support 8-bit characters. 
The semantics for the range notation, which currently uses ordinal values for 
the character, are the same as in previous releases. This permits ranges to 
include: 7-bit characters, 8-bit characters, and 7- and 8-bit characters. 
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Software Description 

Remote File Sharing (RFS) Release 1.2 is a software package that allows 
computers running AT&T 386 UNIX System V Release 3.1 or later releases to 
share resources (directories containing files, subdirectories, devices, and named 
pipes) selectively across a network. Administrators for computers on an RFS 
network can choose directories on their systems they want to share and add 
them to a list of available resources on the network. From this list, they can 
choose resources from remote computers that they would like to use on their 
computers. 

Each computer on a Remote File Sharing system can be grouped with oth- 
ers in a " domain " or can operate as an independent domain. The domain 
can provide a central point for administering a group of computers. Unlike 
other distributed file systems used with the UNIX operating system. Remote 
File Sharing is built into the operating system. This approach has several 
advantages: 

Compatibility Once you mount a remote resource on your system, it will 
look to your users as though it is part of the local system. 
You will be able to use most standard UNIX System features 
on the resource. Standard commands and system calls, as 
well as features such as File and Record Locking, work the 
same on remote resources as they do locally. Applications 
should be able to work on remote resources without modifi- 
cation. 

Security Standard UNIX System file security measures will be avail- 

able to protect your resources. Special means for verifying 
computers and restricting remote user permissions have been 
added for Remote File Sharing. 

Flexibility Since you can mount a remote resource on any directory on 

your system, you have a lot of freedom to set up your 
computer's view of the world. You do not have to open up 
all your files to every host on the network. Likewise, you 
do not have to make all files on the network available to 
users of your computer. 
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New Features 

Two major features have been added to Remote File Sharing Release 1.2: 
client caching and loop-back. 

Client Caching 

The client caching feature of RFS provides substantial performance 
improvements over non-caching systems by reducing the number of times 
data must be read across the network. Client refers to the computer that is 
using a remote resource, while caching refers to the client's ability to store 
data in local buffer pools. 

The first time a client process reads a block of data from a remote 
resource, it is placed in local buffer pools. Subsequent client processes reading 
a server file can avoid network access by finding the data already present in 
local buffers. This generally causes a large reduction in network messages, 
resulting in improved performance. 

In order for client caching to work simply and reliably, the following 
features were built into it. 

■ Cache consistency. Checking mechanisms are used to ensure that the 
cache buffers accurately reflect the contents of the remote file the user 
is accessing. 

■ Transparency. The only difference users should see between caching 
and non-caching systems is improved response time. RFS-based appli- 
cations do not have to be changed to run on a Remote File Sharing sys- 
tem that caches remote data. 

■ Administration. By default, client caching is on. However, options are 
available to turn off caching for an entire system or for a particular 
resource. (You would probably only do this if you have an application 
that does its own network buffering.) There are also some tunable 
parameters available to fine tune your system to the way you use RFS. 

Loop-Back 

The loop-back feature allows you to simulate the higher levels of RFS 
within one computer. For example, you could advertise a resource and mount 
it in a different location on the same machine. 
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The main use of the loop-back feature is to test application programs and 
give RFS demonstrations with only one computer. For information describing 
how to use this feature, see the -o option on the rfadmin(lM) manual page in 
the User's/System Administrator's Reference Manual. 

Software Notes 

This section describes problems that may occur with Remote File Sharing 
and, in some cases, workarounds to those problems. 

acct 

The accounting file passed to the acct(2) system call cannot be remote. 
This restriction applies to user software that uses the system call directly and 
to the process accounting software. RFS does not allow the acct system call; if 
passed a remote path name, acct will return an errno of EINVAL. 

chroot 

If you use the chroot command to change to the root directory of a remote 
machine, the ps command will not work properly. 

Client Caching 

Reads and writes of block special files are not cached because they could 
duplicate other data in the cache (for example, data from a regular file residing 
on the block device defined by the special file). However, if you write to a 
block device special file on a server machine, the contents of regular files on 
the block device may be changed. Client-cache buffers associated with these 
files may be out of date. (Local disk accesses do not suffer from this problem, 
since block-device writes go through the local buffer pool). 

Users who write to block special files on file systems that are advertised 
remotely in a way that affects the contents of regular files should turn off 
caching when the resource containing the device is first mounted. (See the -c 
option of inount(lM).) 
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dff 

If df is used without options, it will list each occurrence of a remote 
resource that is mounted on a system and place an asterisk next to the word 
blocks for the second and each subsequent resource that was advertised under 
the same remote file system (for example, /usr/mail and /usr/bin). This signi- 
fies that the identical block counts for the resources reside under the same file 
system. 

The problem is that if df is used with multiple remote resources passed as 
arguments, the asterisk never appears. In this example, the two resources are 
on the same remote file system, though the asterisk does not appear: 

$df USRMAIL USRBIN 

/mnt/(USRMAIL) 30402 blocks 
/mnt/ (USRBIN) 30402 blocks 

fumount 

The -w option to the fumount command allows you to specify a grace 
period between warning clients that a resource is to be removed and actually 
removing the resource. The atoi subroutine [strtol(3C)] calculates the number 
of seconds. This routine looks for an initial numeric string and converts it to 
an integer. Any non-numeric character in the argument terminates the argu- 
ment. For example, the argument -w 123abc gives a grace period of 123 
seconds. Missing arguments and arguments without an initial numeric string 
produce an error message. 

ffuser 

The fuser command does not find remote users with open local files. For 
example, mount a 1.2 Mbyte floppy file system as /tmp/a. Advertise the /tmp 
directory as resource TMP. Mount the TMP resource on a remote system and 
open a file residing in the TMP /a directory you just mounted. On the local 
system, run fuser /dev/dsk/fO (the floppy). The remote user will not be 
found. 

fuser 

fuser may miss a process if that process gets a reference to the resource 
after fuser has begun its search. In this case, the offending process can be 
killed explicitly with the kill command. When all processes using the 
resource are gone, the resource can be unmounted. 
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idload 

Many ID mapping features do not function properly with the loop-back 
function. Only use global blocks of information in mapping files (uid.rules 
and gid.rules). Within global blocks only default transparent works as 
intended. Specific mapping (map lines) or attempts to use host blocks will 
result in users and groups being mapped to 60002. 

labelit 

labelit performs a check to ensure that the destination device path begins 
with /dev/r?? for tape devices. However, remote tape devices on an RFS net- 
work are typically mounted under a local directory or in /dev. As a result, 
labelit cannot be used over RFS for remote tape devices. 

Logs 

These log files may contain information relating to RFS activities: 

/usr/adm / rjuadmin.log 
/usr/adm /log/ rfuadmin.log 
/usr/net /servers /rfs /rfs.log 
/usr/net/nls/netspec/log 

These files are for internal use only! Customers should not rely on the con- 
tents of these files because the information may change or the file may be 
deleted in future releases. Any tool written that takes advantage of the infor- 
mation contained in these files is not guaranteed to work in the future. (In the 
list above, netspec is replaced by the transport provider used by RFS. For the 
STARLAN NETWORK, the netspec is starlan.) The rfuadmin.log files are NOT 
automatically truncated. You may want to monitor them to make sure they 
do not get too large. 

Iseek 

Using Iseek with a negative offset on a remote file behaves differently 
than on a local file. On a local file, the call fails and returns EINVAL, as it 
always has. However, on a remote file the call succeeds and returns the nega- 
tive offset. 
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mount 

When a mount fails because of a password mismatch, the error message 
can be confusing. The following error messages result from a remote mount 
failure due to mismatched passwords: 

negotiate: An event requires attention 
mount: negotiations failed 

mount: possible cause: machine password incorrect 
mount: could not connect to remote machine 

mount 

When a remote resource is disconnected by a fumount(lM) command or a 
broken link, the default action in the client rfuadmin script is to try to 
remount the resource as it was mounted before. Therefore, if a resource that 
was originally advertised by the server as read/write is readvertised read-only, 
the client's automatic mount will never succeed. 

An administrator can always enter mount directly using the latest adver- 
tised mode. 

mount 

The programs that automatically remount remote resources {/etc/rmount, 
/etc/rmountall, and /usr /nserve /rfuadmin) do not recognize the -c option of 
the /etc/mount command as valid. The result is that when they attempt to 
remount a resource that was disconnected and that was originally mounted 
with client caching turned off [mount(lM) with the -c option], the resource is 
remounted with client caching turned on (the default). 

One possible workaround for this problem is for the administrator to wait 
until the program that does the remount completes successfully, then to 
unmount and to remount the resource manually using the mount -c com- 
mand. The administrator might also consider killing the process that does the 
remount, but there is no assurance that other actions that the process must 
perform will complete successfully. 
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mount 

The mount command returns a different ERRNO and error message than 
it did in UNIX System V Release 3.0. The error occurs when you try to mount 
a local device on a subdirectory of a Remote File Sharing resource you 
mounted from another machine. The previous errno was EMULTIHOP and 
the error message was: 

mount: Multihop attempted 
mount: cannot mount device 

The new errno is EREMOTE and the error message is: 

mount: Object is remote 
mount: cannot mount device 

Name Server 

When the primary and secondary name servers are under heavy load, the 
normal passing of name server information between these machines may 
cause them to hang because the IK Streams buffers have been depleted. 
There is one long-term and one short-term solution to the problem. 

For the long term, you can increase the number of IK Streams buffers in 
/etc/conf/cf.d/mtune. The parameter is NBLK1024. Increasing 2K Streams 
buffers (NBLK2048 parameter) may also help because the system will try to 
use 2K buffers when IK buffers are depleted. 

The short-term solution is that you can stop Remote File Sharing on any 
secondary name server that is hung and then bring it back up again; that will 
clear the NBLK1024 buffers. 

nsquery 

The resource list printed by nsquery does not always reflect the current 
state of the domain. If a resource is advertised and the server goes down, a 
subsequent nsquery from a client may still list the resource as being available, 
even though it is not. An attempt to mount the resource will fail, because it is 
unable to contact the server. You will have to wait for the remote machine to 
make the resource available again. 
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Programs 

If a program creating remote directories or files loses its link to the remote 
machine, and the remote resource is unmounted, the program may begin to 
create local directories and files. For example, if you are using the find com- 
mand piped to cpio to a remote machine and the link to the remote machine 
goes down and the resource is then unmounted, cpio may begin writing on 
the local machine — the target directory now looks just like an ordinary local 
directory. 

Recovery 

Remote File Sharing limits the size of a resource name to 14 characters. 
This is intended to limit only the resource name and not the domain name (if 
addressing a resource from another domain). 

When a resource is mounted, the stated length of domain and resource 
name combinations can be used. However, when a link is broken to a server 
machine, the client's recovery mechanism tries to unmount the server 
resources. In doing so, it calculates the size of the resource name including 
the domain and the " . " that separates them. If this string exceeds 14 charac- 
ters, recovery fails to unmount the resource and may not complete. The result 
is that users will not be able to access the resource, but the resources will still 
be listed when you print the names of locally mounted resources (mount com- 
mand). 

This problem can be solved in one of two ways. If the problem occurs, 
the administrator can manually unmount the resource that is posing the prob- 
lem and then recovery will complete properly (umount -d resource). To avoid 
the problem altogether, the administrator should use domain names and 
resource names that, when concatenated together, will not exceed a total 
length of 14 characters. 

Recovery 

If a client loses its link to a server, any attempt to umount one of that 
server's file systems from the client tree will fail until recovery runs. Recovery 
from a link failure is handled by rfuadmin(lM) and rfudaemon(lM). 

Recovery runs automatically when the link breaks, but not until someone 
tries to access the link or until a maximum of 11 minutes have passed. (The 
11 -minute time interval applies if you are using STARLAN network. The time 
may be different for other transport providers.) 
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If the umount fails because the link is gone, the umount will start 
recovery. After recovery runs, a second umount will succeed. 

rfadmin 

The rfadmin -p command should not be used to pass name server 
responsibilities back to the primary while the RFS domain is in an unstable 
state. After RFS is restarted on the primary, the administrator on the secon- 
dary machine that is the current domain name server should wait until all 
requests to mount resources from the primary are completed. (When the pri- 
mary went down rmount requests were placed in the background on all client 
machines that had mounted resources from the primary.) The secondary 
administrator can safely use rfadmin -p when the mount requests are com- 
pleted. 

rfadmin 

The -p option of the rfadmin command returns a value of 2 if the com- 
mand fails because no computer is available to take over primary name server 
responsibility. 

In earlier releases, the -p option of the rfadmin command returned a 
upon success or a 1 upon failure. In RFS Release 1.1, the -p option returns a 
upon success, a 2 if the command fails because there is no computer avail- 
able to assume primary name server responsibilities, or a 1 if the command 
fails for some other reason. This change gives the rfstop(lM) command the 
ability to warn the administrator if the machine being stopped will cause the 
domain to be without a primary name server. 

rfmaster 

The acting domain name server is responsible for distributing important 
name service information to all other accessible (secondary) name servers that 
are serving the same domain, with no more than a 15-minute lag, so that if 
the acting name server should fail, another host could assume the name server 
role with a minimal loss of information. However, changes to the rfmaster file 
after rfstart has been run are not included in the information that is distri- 
buted in this way. Because the designation of hosts as primary and secondary 
name servers is made in the rfmaster file, this has the consequence of not 
allowing a change to the configuration of which hosts are the primary and 
secondary name servers for a domain without stopping and re-starting RFS on 
the affected hosts. For example, adding a new secondary name server to the 
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rfmaster file will not take effect until RFS is taken down on all of the existing 
(primary and secondary) name servers, as well as the newly designated secon- 
dary and then re-started. 

This limitation should not be confused with the temporary transfer of 
name server responsibility to another one of the hosts already listed in the 
rfmaster file as a primary or secondary name server; this temporary transfer is 
performed with the rfadmin -p command, 

rfmaster 

When rfstart is executed, the name server process (nserve) scans the 
rfmaster file and reports possible errors. However, if there is an entry in the 
rfmaster file that identifies a computer as a name server (either primary or 
secondary), but there is not a corresponding address entry in the rfmaster file 
for that computer, it is not reported as an error, even though it should be. In 
attempting to contact a name server (for example, during rfstart or 
rfadmin -p), name servers with no address listed will be silently skipped. 

rfpasswd 

The rfpasswd command is used to change the host password used for 
RFS, and it is intended to parallel the passwd command in the way it prompts 
for old and new passwords. However, if a host has no password (for exam- 
ple, it has a null password), the rfpasswd command will still prompt for the 
old password before asking for the new one, although it should ask only for 
the new one. 

rfstart 

This problem only happens when you are issuing an rfstart command 
from one terminal and some other RFS command from another terminal. 

Sometimes when you run the rfstart command it will prompt for a pass- 
word. RFS has actually started when the password prompt occurs, so an adv 
command from another terminal would be accepted. After the password is 
entered, rfstart completes, which includes clearing the advertise table. The 
result is that the domain advertise table would show the advertised resource 
as available, while the local advertise table would not. 

This problem can be avoided by not issuing additional RFS commands 
until the rfstart completes and exits to the shell. If the problem does occur, 
use the adv -mi or unadv commands to put the two advertise tables back in 
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agreement. 

rfudaemon 

User-level recovery of resources that are disconnected gracefully (the 
remote system shuts down) may fail if the number of lost resources exceeds 
half of the value of the tunable parameter MAXGDP in /etc/conf/cf.d/mtune 
By default, MAXGDP is 24. The failure is accompanied by one or more of the 
following messages: 

rfs user-daemon queue overflow: 
make sure rfudaemon is running 

STREAMS 

The three system calls related to STREAMS — getmsg, putmsg, and 
poll — will not operate with a file descriptor associated with a remote file. If 
this is attempted, the system call will fail with errno equal to ENOSTR. 

swap 

Swap devices cannot be remote, including the swap device configured ini- 
tially and any swap devices added using the swap(lM) command. 

System Calls 

When a Remote File Sharing server does not recognize an incoming 
request, it will return an EREMOTE. In Release 3.0, unrecognized system 
calls were ignored by the serv«.f . 
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introduction 

The Network Support Utilities (NSU) Release 1.2 package extends system 
capabilities to support networking applications. The package includes 
software support for STREAMS, the AT&T Transport Interface, and the 
Listener. 

The Network Support Utilities package is required to take advantage of 
the following features of AT&T 386 UNIX System V Release 3.1 and later: the 
Remote File Sharing package, STREAMS mechanisms and tools, the AT&T 
Transport Interface, the enhanced Basic Networking Utilities, and the Listener. 

STREAMS 

STREAMS is a general, flexible facility for developing UNIX System com- 
munication services. By defining standard interfaces for character 
input/output within the kernel, STREAMS supports development ranging 
from complete networking protocol suites to individual device drivers. The 
standard interfaces and associated tools enable modular, portable development 
and easy integration of network services and their components — these were 
used to develop protocol modules and device drivers for Release 3. STREAMS 
provides a broad framework that does not impose any specific network archi- 
tecture. It implements a user interface consistent and compatible with the 
character I/O mechanism that is also available in the UNIX System. 

The power of STREAMS resides in its modularity. The design reflects the 
layering characteristics of contemporary networking architectures. Each basic 
component (called a module) in a STREAMS implementation represents a set 
of processing functions and communicates with other modules via a standard 
interface. From the user level, kernel resident modules can be dynamically 
selected and interconnected to implement any rational processing sequence. 
No additional kernel programming, assembly, or link editing is required. 
Modularity allows for the following advantages: 

■ User-level programs (commands such as uucp) can be independent of 
underlying protocols and communications media so the programs need 
not be changed when new media or protocols between systems become 
available. 
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■ Network architectures and higher-level protocols are independent of 
underlying protocols, drivers, and media. 

■ Higher-level services can be created by selecting and connecting lower- 
level services and protocols. 

In addition to the standard interfaces, STREAMS provides a set of 
software tools that help source customers build modules and drivers. 

AT&T Transport Interface 

With Release 3, UNIX System V supports a Transport Interface based on 
the Transport Service Definition (Level 4) of the International Organization for 
Standardization (ISO) Open Systems Interconnection (OSI) reference model. 
The transport service supports two modes of transfer: connection mode and 
connectionless mode. Connection mode is circuit-oriented and supports data 
transfer over an established connection in a reliable, sequenced manner. The 
connectionless mode is message-oriented (datagrams) and supports data 
transfer in self-contained units with no logical relationship required among 
units. 

The AT&T Transport Interface defines how to accesses the services of a 
transport protocol, called a Transport Provider. An example of a Transport 
Provider is the ISO. Application programs access the Transport Provider by 
using the Transport Interface routines in the new Network Services Library. 
These routines support access to a Transport Provider in a media and 
protocol-independent manner. The Transport Provider uses kernel level pro- 
grams to send the information to the desired physical device, such as the 
STARLAN Network. Access Unit (NAU). By using the AT&T Transport Inter- 
face, application programs will be able to access other Transport Providers that 
may be available in the future. 

For more information, see the Network Programmer's Guide and the 
Programmer's Reference Manual. 

Listener 

The " listener " is a program that can be used with Transport Providers on 
a system. The purpose of the listener is to receive requests for services from 
another system, interpret which service is needed, and start a process that has 
been named to provide the requested service. The listener then drops out of 
the communications path and continues to listen for new service requests. 
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For more information about the listener, see nlsadmin(lM) in the 
User's/System Administrator's Reference Manual. Also, see the Basic Network 
Utilities and Remote File Sharing sections of the Operations/System Administra- 
tion Guide for information on how to set up the listener for these products. 

Software Notes 

This section describes problems that may occur with the Network Support 
Utilities and, in some cases, workarounds for these problems. 

Listener 

■ In general, when the listener has trouble binding its listening addresses 
during its start sequence, the actual addresses bound will be chosen by 
the protocol and hence will differ from the ones requested. There are 
two cases where this can happen: when the address requested to be 
bound is either already bound for listening on that network, or when 
that address does not conform to whatever criteria the protocol is 
expecting for an address. 

In both of these cases, the listener will output a message to the console 
stating the address returned by the protocol and 

TLI bound a different name than requested. 

Additionally, the requested address appears in the listener's log file 
along with the messages sent to the console. The listener will then exit. 

■ The listener process can now parse quoted strings in the command line 
in the data base file. 

In the previous release, the listener did not understand quoted strings 
as arguments to servers. If quoted strings were required, it was neces- 
sary to specify a shell script as the server and embed the real server and 
the quoted string arguments there. This change eliminates the need for 
that indirection. 

■ The listener process now runs as root and sets both the user and group 
ID as specified by the user ID in the data base file. 

In the previous release, the listener ran as user ID listen. Because of 
this, servers that required special permissions needed to be owned by 
the appropriate user with the setuser or setgroup ID bits set 
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accordingly. The proliferation of privileged servers was deemed to be a 
potential security hazard. This change allows the administrator to 
specify in the listener data base file the user ID under which the server 
should run: 

nlsadmin -a svc -ccmd -wid -y comment netspec 

The listener will perform setuid and setgid system calls based on this 
ID before exec'ing the server. 

STREAMS 

open 

A race condition exists in clone opens from different inodes. This problem 
exists when two or more disk inodes with the major of the clone device and 
equal minors are being opened at the same time. If the window is hit, then 
another open after the first open may bypass the clone device entirely, thus 
failing. For example, if /dev/nodel was major 63 and minor 57, and 
/dev/nodel was also major 63 and minor 57, and if they were two different 
inodes, then simultaneous opens of the two devices may result in failure of 
the second open. 

If two or more separate files are needed on disk, they should be created as 
links to one disk inode, thereby closing the window. In the previous example, 
/dev/nodel should be linked to /dev/nodel instead of being a separate inode. 

read 

For a STREAMS file, when a message containing 1 or more bytes is read 
and the first message block of the message contains bytes, the message will 
be erroneously treated as a byte message. 

write 

For a STREAMS file, if write is interrupted by a signal after some data 
have been written, it should return the number of bytes written. However, it 
returns -1 and sets errno to EINTR. 

Even when there are no flow control restrictions, write will block if 
STREAMS internal resources are not available, regardless of the state of 
0_NDELAY. 
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STREAMS Programmer's Guide 

In Appendix C, the initial lines of qenable should read as follows: 

qenable - enable a queue 

int qenable(q) 
queue_t *q; 

qenable places the queue pointed at by g ... 

Transport Interface Library 

Network Programmer's Guide 

The reference to tirdwr(7) in the caution note on Page 5-2 should reflect 
the change (in the manual page) that popping the module from a stream no 
longer causes a disconnect. 

t— accept 

The description of TBADDATA has been modified to clarify the condi- 
tion under which it occurs. 

[TBADDATA] The amount of user data specified exceeds the allowed 

amount as returned in the info.connect field by t_open or 
t_getinfo. 

t—connect 

The description of TBADDATA has been modified to clarify the condi- 
tion under which it occurs. 

[TBADDATA] The amount of user data specified exceeds the allowed 

amount as returned in the info.connect field by t_open or 
t_getinfo. 

t_getstate 

t_getstate will not work following an exec(2)/t_sync(3N) call sequence 
because there is insufficient information available to determine the state. The 
problem arises because the state is maintained in a user process data space, 
but an exec will overwrite that data space and the state information will be 
lost. If t_getstate is called in this case, it will fail with t_error set to 
TSTATECHNG. 
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t_rcv 

The processing of expedited transport data units (ETSDU) by t__rcv has 
been modified. The function will now set the T_EXPEDITED flag on return, 
if the data are part of an expedited message. The sentence in the fourth para- 
graph of the DESCRIPTION now reads: 

Subsequent calls to retrieve the remaining ETSDU will have 
T_EXPEDITED set on return. 

t-snddis 

The description of TBADDATA has been modified to clarify the condi- 
tion under which it occurs. 

[TBADDATA] The amount of user data specified exceeds the allowed 

amount as returned in the info.discon field by t_open or 
t_getinfo. 

t— sndudata 

The paragraph describing the EPROTO error has been expanded as fol- 
lows: 

If t_sndudata is issued from an invalid state, or if the amount of data 
specified in udata exceeds the TSDU size as returned by l_open or 
t_getinfo, the provider will generate an EPROTO protocol error (see 
TSYSERR below). However, the t_sndudata may not fail because 
EPROTO errors may not be reported immediately. In this case, a 
subsequent call that accesses the transport endpoint will fail with the 
associated TSYSERR. 

t—sync 

The description of the TBADF value t_errno has been changed to the fol- 
lowing: 

[TBADF] The specified file descriptor does not refer to a transport end- 

point. 
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QcV / QbK / lUQOQ 


UcV / XP-L 


QcV / QbK / lUQOQl 


Hpv /ln9 
UcV / 


QcV / QbK / lyJyJLyU. 


A e^\T / r\YT 
UcV / U*!! 


Ap>\r /HcV /fnHQHf 

QcV / QbK / IUQ-/QI 


A(^\T /yAck /flcS 
UcV / lUoK/ 


Ao\r /fAOARAaR 
QcV/ IQUrtOQbO 


UcV / lUbK/ UoO 


Hmr /fAHARAaQ 
QcV / IQU*iOQb7 


UcV / lilUUv? 


QcV / riQUO 


UcV / lilUU^ 


QcV / llQU'i 


A P^T / vA cl^ / 1 c S 
UcV/ lUbK/ J.S>J 


aev/ riQio 


UcV/rUbK/ IbO 


aev/ riQi^t 


UcV / rubK/ iu>7u 


Ao\r /Hc1<r /f1 
QcV / QbK. / 1 1 


UcV / lUbK/ lUOUl 


QeV/ QSK/ IIOQ 


UcV / rUbK/ lUvJll 


aev/ asK/iuai 


UcV / iQbK / lUOlll 


aev/ asK/iion 


QcV / rabK/ lUOQl D 


aev / QbK / 1 1 oni 


UcV / lUbK / 1U\JU 1 Dl 


Ao\r /Acl- /f1 "^rll A 

aev/asK/iioaio 


UcV / lUbK/ 1U>JU'± 


aev / ObK/ I lOQl Dl 


Hpv ZrHcW /fD'^Hdt 

UcV / lUbK/ lUJU'il 


Ao\r /Ac\^ /f1 

aev / asK/ 1 lOQ^t 


Hpv /rHcW /fflRHRn 
UcV / lUbK/ lU^UOU 


QcV / QbK/ I lOQrtl 


Hpi7 /t*Hc1^ /rOSn 
UcV / lUbK/ 1U«-^U 


aev/ abK/ iicqou 


Hpv /rHcW /fORnf 
UcV / lUaK/ iu^ui 


aev / QbK/ 1 locj 


Hpv /rHcik /fflHRH 

UcV / lUoK/ lUUOU 


aev / QbK/ I UUL 


Hpv /rHQk /fOHRHl- 

UcV / lUoK/ IWUOUl 


aev / QbK / 1 Jl qoq 


Hpv /rAfdc /fDHQH 

UcV / lUSK/ 1UU7U 


QeV / QbK / I IQOQL 


Hpv /rH ciW / fDHQH t 

UcV / lUoK/ 1WU7UL 


aev / QbK/ 1 1Q7Q 


Hpv /rH<;k /f1 

Uc V / 1 USK / A ± 


aev/ abK/ 1 iq^ql 


Hpv /rHciW /f1 '^H 

Uc V / I UoK / 1 1 J U 


rlmr /HcV /f1 n1 Sri 

aev / abK/ 1 lu loa 


Hpv /rHc;k /f1 "^Ht 

UcV / lU&K/ i.X\l^UL 


Ao\r /Acl- /fin'] "iHf 

aev/asK/ iicji jqi 


Hpv /rH<;l<: /fl "^h 

UcV / lUbK /lull 


dev/dsk/flt 


dev/rdsk/fl3ht 


dev /fd048 


dev/rdsk/fl5dl6 


dev/fdl 


dev/rdsk/fl5dl6t 


QcV / IQlrtO 


Hpv /rH<;k /fl SH4 

UcV / lUoK / 1 J.»-'Urt 


dev/fdl48ds8 


dev/rdsk/fl5d4t 


dev/fdl 48ds9 


dev/rfd048 
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dev/sxt/017 


dpv/rfd048ds9 


dev/sxt/020 


Hpv /"tHH 1 

Ll\. V / lllLJ.X«.r 


dev/sxt/021 


Hpv /rhHI 4 

L4.C V / 1 1 iU. ±, ^ 


dev/sxt/022 




dev/sxt/023 


Hpv / rlnrlc 

Lie V / L,lL/L.rV 


dev/sxt/024 


dev/rdsk/fl5d8u 


dev/sxt/025 


Hpv /rdsk / f1 Sn 


dev/sxt/026 


dev/rdsk/fl5qt 


dev/sxt/027 


dev/rdsk/fld8d 


dev/sxt/030 


dpv/rdsk/fld8dt 


dev/sxt/031 


dpv/rdsk/fld9d 

Lie V / ILAO^/ 1 J.U.^\^ 


dev/sxt/032 


dev/rdsk/fld9dt 

Lie V / 1 \>ioxv / X J. d. ^ k 


dev/sxt/033 


dpv /rdsk/flal5d 

Lie V / 1 L4.0IX / 1 X LJ X 


dev/sxt/034 


dpv /rdsk/flal5dt 

Lte V / 1 LlO.^ / X X LI X \^ V^L 


dev/sxt/035 


dpv /rdsk/flt 

Lie V / X UOXV /XXL 


dev/sxt/036 


dev/rfdl 

Lie V / xxux 


dev/sxt/037 


dpv /rfdl48 

Lie V / XXLXX^L/ 


dev/sxt/040 


dpv /rfdl48ds8 

Lie V / X ILl X ^ L'LI.OL' 


dev/sxt/041 


dpv /rfdl48ds9 

Lie V / X ILl X ^LILI.^ ^ 


dev/sxt/042 


dev/rfdl 96 

Lie V / X X\^ X ^ Lf 


dev/sxt/043 


dev/rfdl96dsl5 

Lie V / X X^J. X ^ X ^ 


dev/sxt/044 


Hpv /vnni 

Lie V / X Wv/ L 


dev/sxt/045 


dc V / rtc 


dev/sxt/046 


Hpv /^yt 


dev/sxt/047 


dev/sxt/000 

Lxe V / ljal / v/v/v/ 


dev/sxt/050 


dev/sxt/001 


dev/sxt/051 


dev /sxt/002 

LXe V / ^/VL/ WihB 


dev/sxt/052 


dev/sxt/003 


dev/sxt/053 


dev/sxt/004 

Lie V / W A 


dev/sxt/054 


dev/sxt/005 

Lie V / / 


dev/sxt/055 


dev/sxt/006 

Lie V / oyvL/ V/L/V^ 


dev/sxt/056 


dev /sxt/007 

Lie V / / \J\J i 


dev/sxt/057 


dev /sxt/010 

Lie V / 0>\L / L/ X L/ 


dev/sxt/060 


dev/sxt/011 


dev/sxt/061 


dev/sxt/012 


dev/sxt/062 


dev/sxt/013 


dev/sxt/063 


dev/sxt/014 


dev/sxt/064 


dev/sxt/015 


dev/sxt/065 


dev/sxt/016 


dev/sxt/066 
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dev/sxt/067 


dev/sxt045 


dev/sxt/070 


dev/sxt046 


dev/sxt/071 


dev/sxt047 


dev/sxtOOO 


dev/sxt050 


dev/sxtOOl 


dev/sxt051 


dev/sxt002 


dev/sxt052 


dev/sxt003 


dev/sxt053 


dev/sxt004 


dev/sxt054 


dev/sxt005 


dev/sxt055 


dev/sxt006 


dev/sxt056 


dev/sxt007 


dev/sxt057 


dev/sxtOlO 


dev/sxt060 


dev/sxtOll 


dev/sxt061 


dev/sxt012 


dev/sxt062 


dev/sxt013 


dev/sxt063 


dev/sxt014 


dev/sxt064 


dev/sxt015 


dev/sxt065 


dev/sxt016 


dev/sxt066 


dev/sxt017 


dev/sxt067 


dev/sxt020 


dev/sxt070 


dev/sxt021 


dev/sxt071 


dev/sxt022 


dev/tty 


dev/sxt023 


dev/ttyOO 


dev/sxt024 


dev/xt 


dev/sxt025 


dev/xt/OOO 


dev/sxt026 


dev/xt/OOl 


dev/sxt027 


dev/xt/002 


dev/sxt030 


dev/xt/003 


dev/sxt031 


dev/xt/004 


dev/sxt032 


dev/xt/005 


dev/sxt033 


dev/xt/006 


dev/sxt034 


dev/xt/007 


dev/sxt035 


dev/xtOOO 


dev/sxt036 


dev/xtOOl 


dev/sxt037 


dev/xt002 


dev/sxt040 


dev/xt003 


dev/sxt041 


dev/xt004 


dev/sxt042 


dev/xt005 


dev/sxt043 


dev/xt006 


dev/sxt044 


dev/xt007 
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etc 

etc/.cpiopc 

etc/.fboot 

etc/adduser 

etc/bcheckrc 

etc/brc 

etc/checklist 

etc/chroot 

etc/ckbupscd 

etc/cleanup 

etc/clri 

etc/conf 

etc/conf/bin 

etc /conf /bin /idbuild 

etc / conf /bin /idcheck 

etc /conf /bin /idconfig 

etc /conf /bin /idinstall 

etc /conf /bin /idmkenv 

etc /conf /bin /idreboot 

etc /conf /bin /idtune 

etc/conf/cf.d 

etc /conf /cf .d/init.base 
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Base System Package, 

etc / conf /bin /idmaster 

etc /conf /bin /idmkinit 

etc /conf /bin /idmknod 

etc /conf /bin /idmkunix 

etc /conf /bin /idspace 

etc /conf /cf .d/mdevice 

etc /conf /cf .d/mfsys 

etc /conf /cf .d/mtune 

etc /conf /cf .d / sassign 

etc /conf /cf .d/ sdevice 

etc /conf /cf .d/sfsys 

etc / conf /cf ,d/stune 

etc /conf /cf .d /vuifile 

etc/conf/init.d 

etc /conf /mfsys.d 

etc /conf /mfsys.d /s5 

etc /conf /node.d 

etc /conf /node.d/ asy 

etc /conf /node.d /Ip 

etc/conf/pack.d 

etc /conf /pack.d /asy 

etc /conf /pack.d /asy /Driver.o 

etc /conf /pack.d /asy /space.c 

etc /conf /pack.d /clock 

etc /conf /pack.d /clock/space.c 

etc /conf /pack.d /cpyrt 

etc /conf /pack.d/cpyrt /Driver.o 

etc /conf / pack.d/ cpyrt /space.c 

etc /conf /pack.d / cram 

etc /conf /pack.d /cram /Driver.o 

etc /conf /pack.d /disp 

etc /conf /pack.d /disp /Driver.o 

etc /conf /pack.d /disp /space.c 

etc /conf /pack.d /du 

etc /conf /pack.d/du / stubs.c 

etc /conf /pack.d/fd 

etc /conf /pack.d /f d /Driver.o 
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etc /conf /pack.d /fp 

etc / conf /pack.d /fp /Driver.o 

etc / conf /pack.d /gentty 

etc /conf /pack.d /gentty /Driver.o 

etc /conf /pack.d /hd 

etc /conf /pack.d/hd /Driver.o 

etc / conf /pack.d /ipc 

etc /conf /pack.d /ipc /Driver.o 

etc /conf /pack.d /kd 

etc /conf /pack.d /kd /Driver.o 

etc /conf /pack.d /kd /space.c 

etc /conf /pack.d /kernel 

etc /conf /pack.d/kernel /io.o 

etc/conf/pack.d/kernel/locore.o 

etc /conf /pack.d /kernel /os.o 

etc /conf /pack.d /kernel /space.c 

etc /conf /pack.d /kernel /start.o 

etc/conf/pack.d/lp 

etc /conf /pack.d /Ip /Driver.o 

etc /conf /pack.d /mem 

etc /conf /pack.d /mem /Driver.o 

etc /conf /pack.d/msg 

etc /conf /pack.d /msg/Driver.o 

etc/conf/pack.d/msg/space.c 

etc/conf/pack.d/msg/stubs.c 

etc /conf /pack.d / nmi 

etc /conf /pack.d /nmi /Driver.o 

etc /conf /pack.d /osm 

etc / conf /pack.d /osm /Driver.o 

etc / conf /pack.d /pic 

etc /conf /pack.d /pic /space.c 

etc / conf /pack.d /prf 

etc /conf /pack.d /prf /Driver.o 

etc /conf /pack.d /prf /space.c 

etc /conf /pack.d /prf /stubs.c 

etc / conf /pack.d /rtc 

etc /conf /pack.d/rtc /Driver.o 
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etc/conf/pack.d/s5 

etc /conf /pack.d /s5 /Driver.o 

etc /conf / pack.d/s5 2k 

etc /conf /pack.d/s52k /stubs. c 

etc /conf /pack.d /sem 

etc /conf /pack.d/sem /Driver.o 

etc /conf /pack.d /sem /space.c 

etc /conf /pack.d /sem /stubs.c 

etc /conf /pack.d /shm 

etc /conf /pack.d /shm /Driver.o 

etc /conf /pack.d /shm /space.c 

etc /conf /pack.d /shm /stubs.c 

etc /conf /pack.d /sxt 

etc /conf /pack.d /sxt /Driver.o 

etc /conf /pack.d /sxt /space.c 

etc /conf /pack.d /sxt / stubs.c 

etc /conf /pack.d / vx 

etc /conf /pack.d / vx /Driver.o 

etc /conf /pack.d / vx /space.c 

etc/conf/pack.d/vx/stubs.c 

etc /conf /pack.d /weitek 

etc /conf /pack.d /weitek /Driver.o 

etc /conf /pack.d /weitek /space.c 

etc /conf /pack.d / weitek /stubs.c 

etc /conf /pack.d /xsd 

etc /conf / pack.d /xsd /Driver.o 

etc /conf /pack.d /xsd /space.c 

etc /conf /pack.d /xsd /stubs.c 

etc /conf /pack.d /xsem 

etc /conf /pack.d / xsem /Driver.o 

etc /conf /pack.d /xsem /space.c 

etc /conf / pack.d /xsem /stubs.c 

etc /conf /pack.d /xt 

etc /conf /pack.d /xt /Driver.o 

etc /conf /pack.d /xt /space.c 

etc /conf /pack.d /xt /stubs.c 

etc/conf/rc.d 

etc/conf/sd.d 

etc /conf /sdevice.d 

etc /conf /sdevice.d /asy 



etc /conf /sdevice.d /cpyrt 
etc /conf / sdevice.d /cram 
etc /conf /sdevice.d /du 
etc /conf /sdevice.d /fd 
etc /conf /sdevice.d /fp 
etc /conf / sdevice.d /gentty 
etc /conf /sdevice.d /hd 
etc /conf /sdevice.d/ipc 
etc /conf /sdevice.d/kd 
etc /conf /sdevice.d/lp 
etc /conf /sdevice.d /mem 
etc /conf /sdevice.d /msg 
etc /conf / sdevice.d /nmi 
etc /conf /sdevice.d /osm 
etc /conf /sdevice.d /prf 
etc /conf / sdevice.d /rtc 
etc /conf /sdevice.d /s52k 
etc /conf /sdevice.d /sem 
etc /conf /sdevice.d /shm 
etc /conf /sdevice.d /sxt 
etc /conf /sdevice.d /vx 
etc /conf /sdevice.d/ weitek 
etc /conf /sdevice.d /xsd 
etc /conf /sdevice.d /xsem 
etc / conf /sde vice . d/xt 
etc/conf/sfsys.d 
etc /conf /sfsys.d/s5 
etc/crash 
etc/cron 
etc/cshrc 
etc/custom 
etc/dcopylK 
etc/dcopy2K 
etc/dcopy512 
etc/default 
etc /default /login 
etc/default/su 
etc/default/tar 
etc / default /xrestor 
etc/deluser 
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etc/dfsck 
etc/df space 
etc/diskadd 
etc/dumpsave 
etc/ff 

etc/filesave 

etc/fixperm 

etc/fsanck 

etc/fsck2K 

etc/fsck512 

etc/fsdb 

etc/fsstat 

etc/fstab 

etc/fstyp 

etc/fstyp.d 

etc/fstyp.d/S51Kfstyp 
etc/fstyp.d/S52Kfstyp 
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etc/fsdb2K 

etc/fsdb512 

etc/fstyp.d/xxfstyp 

etc/fuser 

etc/getclk 

etc/getty 

etc/gettydefs 

etc/grpck 

etc/idrc.d 

etc/idsd.d 

etc/init.d 

etc/init.d/README 

etc /init.d/RMTMPFILES 

etc/init.d/disks 

etc/init.d/firstcheck 

etc/init.d/lp 

etc/issue 

etc/killall 

etc/ldsysdump 

etc/link 

etc/links 

etc/magic 

etc/mkfs2K 

etc/mkfs512 

etc/motd 

etc/mountall 

etc/mvdir 

etc/ncheck 

etc/perms 

etc/prfdc 

etc/prfld 

etc/prfpr 

etc/prfsnap 

etc/prfstat 

etc/profile 

etc/pwck 

etc/rcO 



etc/rcO.d 

etc/rcO.d/KOOANNOUNCE 

etc/rc0.d/K70uucp 

etc/rc0.d/K75cron 

etc/rcl 

etc/rc2 

etc/rc2.d 

etc /rc2.d /SO IMOUNTFSYS 

etc /rc2.d /S05RMTMPFILES 

etc /rc2.d /S20sysetup 

etc/rc2.d/S21perf 

etc/rc3 

etc/rc3.d 

etc/rstab 

etd/setclk 

etc/setmnt 

etc/shutdown 

etc/stdprofile 

etc/sulogin 

etc/swap 

[etc/sysdef 

etc/termcap 

etc/ttytype 

etc/umountall 

etc/unlink 

etc/volcopy 

etc/ wall 

etc/whodo 

etc/xinstall 

lib 

lib/idcomp 

lib/idcpp 

usr 

usr/adm 
usr/adm/acct 
usr /adm /acct /fiscal 
usr / adm /acct / nite 
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usr /adm /acct /sum 

usr/adm/sa 

usr/bin 

usr/bin/300 

usr/bin/300s 

usr/bin/4014 

usr/bin/450 

usr/bin/adv.nf 

usr/bin/asa 

usr/bin/at 

usr/bin/awk 

usr /bin /backup 

usr/bin/banner 

usr/bin/batch 

usr/bin/bc 

usr /bin /bdiff .nf 

usr/bin/cal 

usr /bin /calendar 

usr/bin/cancel 

usr /bin /captoinfo 

usr /bin /checkeq 

usr/bin/chrtbl 

usr/bin/cpset 

usr /bin /crontab 

usr/bin/ct 

usr/bin/cu 

usr/bin/cut 

usr /bin /displaypkg 

usr/bin/f actor 

usr/bin/greek 

usr /bin /installpkg 
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usr/bin/dc 

usr/bin/disable 

usr/bin/enable 

usr/bin/getopt 

usr/bin/graph 

usr/bin/hp 

usr/bin/id 

usr /bin /infocmp 

usr/bin/ismpx 

usr/bin/join 

usr/bin/jterm 

usr/bin/jwin 

usr/bin/layers 

usr /bin /logname 

usr/bin/lp 

usr/bin/lpstat 

usr/bin/n\ailx 

usr/bin/mcs 

usr /bin /message 

usr/bin/more 

usr/bin/news 

usr /bin /nlsadmin.nf 

usr/bin/oawk 

usr /bin /passmgmt 

usr/bin/paste 

usr/bin/pg 

usr /bin / pwconv 

usr /bin /p wdmenu 

usr /bin /random 

usr/bin /removepkg 

usr/bin/restore 

usr/bin/sag 

usr/bin/sar 

usr/bin/shl 

usr/bin/spline 

usr/bin/tabs 

usr/bin/tar 



usr/bin/tic 

usr/bin/timex 

usr/bin/tplot 

usr/bin/tput 

usr/bin/tr 

usr/bin/units 

usr/bin/uucp 

usr/bin/uulog 

usr /bin / uuname 

usr/bin/uupick 

usr/bin/uustat 

usr/bin/uuto 

usr/bin/xargs 
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usr/bin/uux 

usr/bin/xtd 

usr/bin/xtract 

usr/bin/xts 

usr/bin/xtt 

usr/include 

usr /include /agent.h 

usr/include/pn.h 

usr /include /shadow.h 

usr/include/sys 

usr /include /sys /acct.h 

usr /include /sys / adv.h 

usr /include /sys /alttbl.h 

usr/include/sys/ascii.h 

usr/include/sys/asy.h 

usr /include /sys /at_ansi.h 

usr /include /sys /bitmasks.h 

usr /include / sys /bootinfo.h 

usr /include /sys /buf .h 

usr/include/sys/callo.h 

usr /include /sys /cdump.h 

usr /include /sys / cirmgr.h 

usr /include / sys /clock.h 

usr/include/sys/clockcal.h 

usr/include/sys/cmn_err.h 

usr /include /sys /comm.h 

usr /include /sys /conf .h 

usr /include / sys /cram.h 

usr /include / sys /crtctl.h 

usr /include /sys /debug.h 

usr /include /sys /debugreg.h 

usr /include /sys /dir.h 

usr /include /sys /dirent.h 

usr /include /sys /dma.h 

usr /include /sys /elog.h 

usr /include / sys /emap.h 

usr /include /sys /erec.h 



usr /include /sys /err.h 
usr/include/sys/errno.h 
usr /include / sys / fblk.h 
usr /include /sys / fcntl.h 
usr /include /sys /f d.h 
usr /include /sys /fdisk.h 
usr /include / sys /file.h 
usr /include / sys / filsys.h 
usr /include / sys /flock.h 
usr /include /sys /fp.h 
usr /include /sys /fs 
usr /include / sys / fs /prf cntl.h 
usr /include / sys / fs /sSdir.h 
usr /include /sys /fs /s5 fblk.h 
usr /include /sys /fs/ sSfilsys.h 
usr /include /sys /fs / sSinode.h 
usr /include / sys /fs /sSmacros.h 
usr/include / sys / fs /sSparam.h 
usr /include / sys /fsid.h 
usr/include / sys /fstyp.h 
usr /include /sys /gate.h 
usr /include /sys /gdpstr.h 
usr /include /sys /getpages.h 
usr /include /sys /hd.h 
usr /include /sys /hetero.h 
usr/include / sys/idtab.h 
usr/include / sys /immu.h 
usr /include /sys /inline.h 
usr /include /sys /inch 
usr /include /sys /inode.h 
usr /include /sys /iobuf .h 
usr/include/sys/ioctl.h 
usr /include /sys /ipc.h 
usr/include/sys/ipl.h 
usr /include /sys /istk.h 
usr /include /sys /ivlab.h 
usr/include /sys /jioctl.h 
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usr/include/sys/kd.h 
usr /include /sys /lock.h 
usr /include /sys /locking.h 
usr /include /sys /Ip.h 
usr /include /sys /macro.h 
usr /include / sys / map.h 
usr /include /sys /message.h 
usr /include /sys /mount.h 
usr /include /sys /msg.h 
usr /include /sys /nami.h 
usr /include /sys /nserve.h 
usr /include /sys /open.h 
usr /include /sys /page.h 
usr /include / sys /param.h 
usr /include / sys /pf dat.h 
usr /include /sys /pic.h 
usr /include /sys /pit.h 
usr /include /sys /poll.h 
usr/include /sys /proc.h 
usr /include /sys /proctl.h 
usr /include /sys /que.h 
usr /include /sys / queue.h 
usr /include /sys /ramd.h 
usr /include /sys /rbuf .h 
usr /include /sys /rdebug.h 
usr/include /sys /recover.h 
usr /include /sys /reg.h 
usr /include /sys /region.h 
usr /include /sys /rfsys.h 
usr /include / sys /rtc.h 
usr /include /sys /sd.h 
usr /include /sys /seg.h 
usr /include /sys /sem.h 
usr /include /sys /sema.h 
usr /include /sys /shm.h 
usr/include/sys/signal.h 
usr /include /sys /stat.h 
usr /include /sys /statfs.h 
usr/include /sys /stermio.h 
usr/include /sys /stream.h 



usr /include /sys /stropts.h 
usr /include /sys / strstat.h 
usr/include/sys/swap.h 
usr /include /sys /sxt.h 
usr /include /sys /sysi86.h 
usr /include /sys /sysinfo.h 
usr /include /sys /sysmacros.h 
usr /include /sys /systm.h 
usr /include /sys /termio.h 
usr/include /sys /tihdr.h 
usr /include /sys /timeb.h 
usr /include /sys /times.h 
usr /include /sys /timod.h 
usr /include /sys /tiuser .h 
usr/include/sys/trace.h 
usr/include /sys /trap.h 
usr/include /sys /tss.h 
usr /include /sys /ttold.h 
usr /include /sys / tty .h 
usr /include /sys /tuneable.h 
usr /include /sys /types.h 
usr /include /sys /uadmin.h 
usr /include /sys /ulimit.h 
usr /include /sys /user.h 
usr /include /sys /ustat.h 
usr /include /sys /utsname. h 
usr/include/sys/v86.h 
usr /include /sys /var.h 
usr /include /sys /vt.h 
usr /include /sys / vtoc.h 
usr /include /sys /weitek.h 
usr /include /sys /x.out.h 
usr /include /sys /xdebug.h 
usr /include /sys /xque.h 
usr/include/sys/xt.h 
usr /include /sys /xtproto.h 
usr /include /tiuser.h 
usr/include / windows.h 
usr/lbin 

usr/lbin/Install.sh 
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usr/lbin/fsinfo 
usr /Ibin /installpkg.r 
usr /Ibin /removepkg.r 
usr/lib 

usr/lib/455_filter 
usr/lib/473_filter 
usr/lib/475_iilter 
usr/lib/5310 
usr /lib / ATT_s_filter 
usr/lib/HP_filter 
usr/lib/accept 
usr/lib/acct 
usr /lib /acct /acctcms 
usr /lib /acct /acctcon 1 
usr /lib /acct /acctcon2 
usr /lib /acct /acctdisk 
usr /lib /acct /acctdusg 
usr /lib /acct /acctmerg 
usr /lib /acct /accton 
usr /lib /acct /acctprc 1 
usr /lib /acct /acctprc2 
usr /lib /acct /acctwtmp 
usr /lib / acct /chargef ee 
usr /lib /acct /ckpacct 
usr /lib /acct /diskusg 
usr /lib /acct /dodisk 
usr /lib /acct /f wtmp 
usr /lib/acct /holidays 
usr /lib /acct /lastlogin 
usr /lib / acct /monacct 
usr /lib /acct /nulladm 
usr /lib /acct /prctmp 
usr /lib /acct /prdaily 
usr /lib / acct /prtacct 
usr /lib /acct /ptecms.awk 
usr /lib /acct /ptelus.a wk 
usr /lib /acct /remove 
usr /lib / acct /runacct 
usr /lib /acct /shutacct 
usr /lib /acct /startup 



usr/lib/acct/turnacct 

usr /lib /acct / wtmpfix 

usr/lib/calprog 

usr/lib/cron 

usr /lib /cron / .proto 

usr /lib /cron /at.allow 

usr /lib /cron /at.deny 

usr/lib /cron / cron.allow 

usr /lib /cron /cron.deny 

usr /lib /cron /logchecker 

usr /lib / cron /queuedef s 

usr/lib/custom 

usr /lib /custom /help 

usr/lib/diffh 

usr /lib /getoptcvt 

usr/lib/hp2631a 

usr /lib /lay ersy s 

usr /lib /layersys /Isys . 8; 7;3 

usr /lib /layersys /Isys . 8; 7;5 

usr/lib/layersys/lsys.8;8;6 

usr /lib /layersys /relogin 

usr/lib/layersys/set_enc.j 

usr /lib /layersys / wtinit 

usr/lib/lib.b 

usr/lib/lib300.a 

usr/lib/lib300s.a 

usr/lib/lib4014.a 

usr/lib/lib450.a 

usr/lib/libgen.a 

usr/lib/libp 

usr/lib/libplot.a 

usr/lib/libsec.a 

usr/lib/libvtO.a 

usr /lib /libwindows.a 

usr/lib/lpfilter 

usr /lib /Ipf orms 

usr/lib/mailx 

usr /lib /mailx /mailx.help 

usr/lib/mailx/mailx.help. 

usr /lib /mailx /rmmail 
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usr/lib/more.help 

usr/lib/pprx 

usr/lib/prx 
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Base System Pac 

usr /lib /Ipadmin 

usr/lib/lpmove 

usr/lib/lpsched 

usr/lib/lpshut 

usr/lib/lpusers 

usr/lib/mv_dir 

usr/lib/reject 

usr/lib/sa 

usr/lib/sa/sal 

usr/lib/sa/sa2 

usr/lib/sa/sadc 

usr/lib/t300 

usr/lib/t300s 

usr/lib/t4014 

usr/lib/t450 

usr /lib /terminf o 

usr /lib /terminf o / 1 

usr /lib /terminfo /2 

usr /lib /terminfo /3 

usr /lib /terminfo /4 

usr /lib /terminfo /4/40- 1 32-6 

usr /lib /terminfo /4/40- 1 32-8 

usr/lib/terminfo/4/40-80-6 

usr /lib /terminfo/4 /40-80-8 

usr /lib /terminfo /4/435 

usr /lib /terminfo /4 /43ro 

usr /lib /terminfo /4 /442 

usr /lib /terminfo /4 /444 

usr /lib /terminfo /4 /446 

usr /lib /terminfo /4/44 7 

usr /lib /terminfo /4 /455 

usr /lib /terminfo /4 /45 7 

usr /lib /terminfo /4 /45 8 

usr /lib /terminfo /4 /4 70 

usr /lib /terminfo /4/471 

usr /lib /terminfo /4/4 73 

usr /lib /terminfo /4/4 74 
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usr /lib /terminfo /4 /475 

usr /lib /terminfo /4 /476 

usr /lib /terminfo /4/4 77 

usr /lib /terminfo /4/477-455 

usr /lib /terminfo /4 /4 77-4 70 

usr /lib /terminfo /4 /4 77ibmc 

usr /lib /terminfo /4 /477ibmg 

usr /lib /terminfo /4/4 77qume 

usr /lib /terminfo /4 /478 

usr /lib /terminfo /4 /4 79 

usr /lib /terminfo /4 /495hp 

usr /lib /terminfo /4 /495ibm 

usr /lib /terminfo /4 /495qume 

usr /lib /terminfo /5 

usr /lib /terminfo /5/53 1 

usr/lib/terminfo/5/5320 

usr /lib /terminfo / 6 

usr /lib /terminfo / 7 

usr /lib /terminfo / 7/ 74 75 

usr/lib/terminfo/8 

usr /lib /terminfo /9 

usr /lib /terminfo /A 

usr /lib /terminfo /A / AT3 86 

usr/lib/terminfo/A/AT386-M 

usr/lib/terminfo/A/AT386-UL 

usr /lib /terminfo /B 

usr /lib /terminfo /M 

usr /lib /terminfo /P 

usr /lib /terminfo /a 

usr /lib /terminfo /b 

usr /lib /terminfo /c 

usr /lib /terminfo / d 

usr /lib /terminfo /e 

usr /lib /terminfo /f 

usr /lib /terminfo /g 

usr /lib /terminfo /h 

usr /lib /terminfo /h /hplaserjet 
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usr /lib /terminfo /i 

usr /lib /terminfo /i /ibmgraphics 

usr /lib /terminfo /i /ibmproprinter 

usr /lib /terminfo /j 

usr /lib /terminfo /k 

usr /lib /terminfo /I 

usr /lib /terminfo /m 

usr /lib / terminfo /n 

usr /lib /terminfo /o 

usr /lib /terminfo /p 

usr /lib / terminfo /q 

usr /lib / terminfo /r 

usr /lib /terminfo /s 

usr /lib /terminfo /s /sprint 1 1 

usr /lib / terminfo /t 

usr /lib /terminfo /u 

usr /lib /terminfo /u /unknown 

usr /lib /terminfo /v 

usr /lib /terminfo /w 

usr /lib / terminfo /x 

usr /lib /terminfo /y 

usr /lib /terminfo /z 

usr/lib/unittab 

usr/lib/uucp 

usr /lib / uucp /Devconfig 

usr /lib / uucp /Devices 

usr /lib /uucp /Dialcodes 

usr /lib /uucp /Dialers 

usr /lib / uucp /Maxuuscheds 

usr /lib /uucp /Maxuuxqts 

usr /lib /uucp /Permissions 

usr /lib /uucp /Poll 

usr /lib /uucp /SetUp 

usr /lib /uucp /Sysf iles 

usr /lib /uucp /Systems 

usr /lib /uucp /Uutry 

usr /lib /uucp /nttysrv 

usr/lib /uucp / remote.unknown 

usr/lib /uucp /uucheck 

usr /lib /uucp /uucico 



usr /lib / uucp / uucleanup 
usr/lib/uucp/uudemon. admin 
usr /lib /uucp /uudemon.cleanu 
usr/lib/uucp/uudemon.hour 
usr /lib / uucp / uudemon.poll 
usr /lib /uucp /uugetty 
usr /lib / uucp /uusched 
usr /lib / uucp / uuxqt 
usr/lib/vplot 
usr/mail 
usr/mail/:saved 
usr/news 
usr/pub 
usr/pub/ascii 
usr/spool 
usr /spool / cron 
usr /spool / cron /atjobs 
usr /spool /cron /crontabs 
usr /spool /cron /crontabs /adm 
usr /spool /cron /crontabs /root 
usr /spool / cron /crontabs /sy s 
usr /spool /locks 
usr/spool/lp 
usr /spool /Ip /adm 
usr /spool /Ip /adm 
usr /spool /Ip /adm: 
usr /spool /Ip /adm: 
usr /spool /Ip /adm 
usr /spool /Ip /adm 
usr /spool /Ip /adm 
usr /spool /Ip /adm 
usr /spool /Ip /bin 
usr /spool /Ip /bin /alert.proto 
usr/spool/lp/bin/drain.output 
usr /spool /Ip /bin /Ip.cat 
usr/spool /Ip /bin /Ip.page 
usr /spool /Ip /bin /Ip.set 
usr /spool /Ip /bin /Ip. tell 
usr /spool /Ip /bin /Ipsched. jr 
usr /spool /Ip /bin /slow.filter 



ns 

ns/lp 

ns/lp/classes 
ns/lp/forms 
ns /Ip/ interfaces 
ns/lp/logs 
ns/lp/printers 
ns/lp/pwheels 
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usr /spool /Ip/ fifos 

usr /spool /Ip /fifos / private 

usr /spool /Ip /fifos /public 

\sr /spool /Ip /logs 

usr /spool /Ip /model 

usr /spool /Ip /model / 1 640 

usr /spool /Ip /model /53 1 

usr /spool /Ip /model /dqp 1 

usr /spool /Ip /model /dumb 

usr /spool /Ip /model /f450 

usr /spool /Ip /model /hp 

usr /spool /Ip /model /lqp40 

usr /spool /Ip /model /ph. daps 

usr /spool /Ip /model /pprx 

usr /spool /Ip /model /prx 

usr /spool /Ip /model /standard 

usr /spool /Ip /requests 

usr /spool /Ip /system 

usr /spool /Ip /temp 

usr /spool /Ip /temp /435_table 

^isr /spool /Ip /temp /455_table 

usr /spool/lp/ temp /4 73_table 

usr /spool /Ip /temp /4 75_table 

usr /spool /Ip / temp /HP_table 

usr/spool/uucp 

usr /spool /uucp / .Admin 

usr/spool /uucp/. Corrupt 

usr/spool /uucp/. Log 

usr/spool/uucp/.Log/uucico 

usr/spool/uucp/.Log/uucp 

usr /spool /uucp/. Log/ uux 

usr /spool /uucp / . Log/uuxqt 

usr /spool /uucp/. Old 

etc/.installdate 

etc/.installstart 

etc/emulator.rell 

'isr /spool /uucp/, Sequence 

isr /spool /uucp/. Status 

usr /spool /uucp/. Workspace 

usr/spool/uucp/.Xqtdir 



usr /spool /uucppublic 
usr/tmp 
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Editing Pacicage, Diskette 1 of 1 



Size 


hstop 


spellprog 


hlistb 




hlista 


hashmake 


spell 


hashcheck 


dircmp 


exrecover 


diff3 


expreserve 


install 


diffSprog 


Name 


vi 


Remove 




Files 


uniq 




split 




saiii 




pack 




nl 




newform 




fgrep 




egrep 




deroff 




ctags 




csplit 




coimn 




col 








Daiii 




sum 




od 




spellhist 




fr 

ir 




Pg 




paste 




join 




cut 




touch 




tail 




exstrings 




compress 





Installation Diskette Files A-21 



Appendix A: Installation Diskette Files 



Network Support Utility Package, 
Diskette 1 of 1 



Size 


pt_chmod 


libnsL—S.a 


listen 


clone/Master 


listen.h 


clone /System 


libnls.a 


clone/Driver.o 


nlsadmin 


log/Master 


strace 


log/System 


strerr 


log/Node 


strclean 


log/Space.c 


Files 


log/Driver.o 


Name 


timod/Master 


Install 


timod/System 


Remove 


timod/Space.c 


Idterm.h 


timod/Driver.o 


ptem.h 


tirdwr/Master 


ptms.h 


Hrdwr /System 


lihdr.h 


iidwr/Space.c 


log.h 


tirdwr /Driver, o 


strlog.h 


Idterm /Master 




Idterm/System 




Idterm/Space.c 




Idterm/Driver.o 




ptem/Master 




ptem/System 




ptem/Space.c 




ptem/Driver.o 




ptm/Master 




ptm/System 




ptm/Space.c 




ptm/Node 




ptm/Driver.o 




pts/Master 




^ts/System 




^^ts/Node 




pts/Driver.o 




libpt.a 
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Remote File Sharing Pacicage, Disicette 1 of 1 



dufst/Sfsys 

dufst/Driver.o 

sp/Master 

sp/System 

sp/Node 

sp/Space.c 

sp/Driver.o 

adv 

dname 

fumount 

fusage 

idload 

nserve 

nsquery 

ri—rmount 

n_rumount 

n_rmnttry 

rfadmin 

rfpasswd 

rfsetup 

rfstart 

rfstop 

rfuadmin 

rfudaemon 

rmntstat 

rmount 

rmountall 

rumountall 

unadv 

fumounts 



du/System 

du/Space.c 

du/Driver.o 

dufst/Master 

dufst/System 

dufst/Mfsys 



Size 



rfs 

rumounts 

adv.init 

Files 

Name 

Install 

Remove 
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Remote Terminal Package, Diskette 1 of 1 



^ristal 




install /visual. ti 


stal 


1/INSTALL 


new 


instal 


1/Rlist 


new /usr 


insta] 


l/UNINSTALL 


new/usr/lib 


instal 


l/adds.ti 


new/usr/lib/tabset 


instal 


l/annarbor.ti 


new /usr /lib/tabset/3101 


instal 


l/ansi.ti 


new /usr /lib /tabset/beehive 

III 1 


instal 


1/att.ti 


new /usr /lib /tabset/std 


instal 


l/beehive.ti 


new /usr /lib /tabset /teleray 


instal 


l/cdc.ti 


new /usr /lib /tabset / vt 1 00 


instal 


l/colorscan.ti 


new /usr /lib /tabset /xerox 1720 


instal 


l/contel.ti 


new /usr /lib /terminfo 


instal 


l/datamedia.ti 


new /usr /options 


instal 


1/dec.ti 


new /usr /options /terminf .name 


instal 


1/diablo.ti 




instal 


1/ fortune, ti 




instal 


I / general. ti 




' istal 


l/hardcopy.ti 




Istal 


l/hazeltine.ti 




instal 


1/hds.ti 




instal 


I/heath.ti 




instal 


1/homebrew.ti 




instal 


1/hp.ti 




instal 


1/lsi.ti 




instal 


l/microterm.ti 




instal 


l/misc.ti 




instal 


l/pc.ti 




instal 


1 / perkinelmer. ti 




instal 


1/print.ti 




instal 


1/setup 




instal 


1/special.ti 




instal 


l/sperry.ti 




instal 


l/tektronix.ti 




instal 


1/teleray.ti 




*stal 
.astal 


1/televideo.ti 




1/ti.ti 




instal 


1/tymshare.ti 
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Security Administration Package, 
Disicette 1 of 1 

Size 

libcrypt_d,a 

makekey 

crypt 

Remove 

Name 

Files 

Install 
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2 Kilobyte File System Utility Package, 
Diskette 1 of 1 

/ize 

Driver, o 

Master 

Mfsys 

Sfsys 

System 

Space.c 

Stubs, c 

Name 

Files 

Install 

Remove 

fsba 
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XENIX File System Utility Package, 
Diskette 1 of 1 

Size 

Driver.o 

Master 

Mfsys 

Sfsys 

System 

Stubs.c 

Name 

Files 

Install 

Remove 

xfsck 

xxfblk.h 

xxfilsys.h 
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Extended Terminal Interface Utility Package, 
Diskette 1 of 1 



dize 

Files 

Install 

Name 

Remove 

usr/lib/tamhelp 
usr/lib/libxtermcap.a 
usr /lib /libxcurses.a 
usr/lib/libcurses.a 
usr/lib/libtam.a 
usr/lib/libpanel.a 
usr /lib /libmenu.a 
usr /lib /libf orm.a 
usr /include /xcurses.h 
usr /include /eti.h 
' isr /include /tam /sys / signal.h 
ir /include /tam /sys /mouse.h 
usr /include /tam /sys /iohw.h 
usr /include /tam /sys /window.h 
usr /include /tam /temp.h 
usr /include /tam /sys /f ont.h 
usr /include / tam /tamwin.h 
usr /include /tam / pbf .h 
usr /include /tam / form.h 
usr /include /tam /tam.h 
usr /include / tam / wind.h 
usr /include /tam /print.h 
usr /include /tam / message.h 
usr /include /tam /chartam.h 
usr /include /tam /subcurses.h 
usr /include /tam /kcodes.h 
usr /include /tam / menu.h 
"^■jr /include /tam /track.h 
Jr/lib/llib-ltam.ln 
usr/lib/llib-ltam 
usr /include /panel.h 



usr /lib /llib-lpanel.ln 
usr /lib /llib-lpanel 
usr /include /form.h 
usr /lib /llib-lform.ln 
usr /lib /llib-lf orm 
usr/include/menu.h 
usr /lib /llib-lmenu.ln 
usr /lib /llib-lmenu 
usr/lib /llib-lcurses.ln 
usr /lib /llib-lcurses 
usr /include /unctrl.h 
usr /include /term . h 
usr/include/curses.h 
usr /include /windows.h 
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Documentation Updates 

The following change pages reflect last minute changes to the AT&T 
UNIX System V/386 Release 3.2 documentation. These change pages should 
be inserted into the Operations /System Administration Guide per the following 
instruction. 



AT&T UNIX SYSTEM V/386 RELEASE 3.2 
OPERATIONS/SYSTEM ADMINISTRATION GUIDE 
UPDATES 

This update involves the following action: 

1. ACTION: Replace page 9-11 through page 9-14 of Chapter 9 with the 
new pages. 
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Setting Up RFS 



In most cases, you will not need the set of tasks described in this section 
because the basic RFS configuration and reconfiguration can be handled usinj- 
the commands described earlier in this chapter. These tasks are for those who 
want to go deeper into the workings of RFS or are having problems with par- 
ticular components. 

These tasks are run from the shell. They should be run initially in the 
order described. 

Once these tasks are completed, go to the " Starting/Stopping RFS " sec- 
tion for information on starting RFS. 

Prerequisites 

Before you begin setting up RFS, the following must be installed and run- 
ning: UNIX System V Release 3.1 (or later) software. Remote File Sharing Util- 
ities, Networking Support Utilities, and transport provider software. (See the 
Remote File Sharing Release Notes and the transport provider manuals that 
accompany the product for installation instructions.) 

You must also log in as root. 

Set Node Name 



Changing the node name of your computer requires careful 
coordination with all machines that communicate with yours 
using Remote File Sharing or other communications packages 
that rely on node name. 

Check to see if your computer's node name is set to the name you want 
(uname -n). If it's not, set it by typing 

uname -S nodename 

A node name that is valid for RFS can consist of up to eight characters of 
letters (uppercase or lowercase), digits, hyphens (-), and underscores (_). 
Some networks, such as the STARLAN network, require that every node 
name in the network be different. RFS, however, only requires that every 
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node name in a domain be different. 



3et Up Network Listener 

If you have installed the Networking Support Utilities, the AT&T imple- 
mentation of the STARLAN network, and RFS in the order described in 
Chapter 2, " Software Installation, " you can skip this task. The listener will 
already be installed and set up to run automatically, and RFS will be listed as 
an available service. 

If you are using another transport provider or suspect that your STARLAN 
network listener is set up improperly, this task will show how to manually set 
up the listener. In the following example, the STARLAN network is used. To 
set up the listener for other networks compatible with the AT&T Transport 
Interface, you should replace starlan with the name of the network (network 
specification) you are installing. (For more details, see the nlsadmin{lM) 
manual page in the User's /System Administrator's Reference Manual.) 

To determine if the listener is properly installed and set up for use by RFS, 
vpe the following: 

nlsadmin — v starlan 

If service code 105 is listed, then the listener is configured to be used for RFS. 

Run the following commands if the listener is not properly set up. If you 
run any of these commands and they have already been run, you will receive 
a message telling you so. This will not harm your listener configuration. 
Type 

nlsadmin — i starlan 

to initialize the files needed for the listener process for the network specified, 
in this case starlan. 

Next, type 

nlsadmin —a 105 — c /usr/net/servers/rf s/rf setup — y "rfsetup" starlan 

to add the RFS service (rfsetup) to the list of services available to the starlan 
■stener. 

Use the following command line to report the status of the starlan listener 
process installed on this machine (ACTIVE or INACTIVE): 
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nlsadmin — x 
Next, type 

nlsadmin —1 "nodename . serve " — t "nodename" starlan 

to register the network addresses of your machine. The listener will listen for 
requests for these addresses on the network. Only the -1 address is required 
by RFS. The -t address is used only for terminal services and may not be 
needed on all networks. 

To start the listener, type 

nlsadmin — S starlan 

Normally, it will be started automatically when your machine enters multi- 
user mode (init 2). 

Set the Domain Name 

Set the domain name by typing 
dname -D domain 

where domain is replaced by the domain of which your machine will be a 
member. The domain name must: 

• contain no more than 14 characters 

• consist of any combination of letters (uppercase or lowercase), digits, 
hyphens, and underscores 

• be different from the name of any other domain used on the network if 
there is more than one domain on your network 

You can check the current domain name by typing: 
dname 
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Set the Transport Provider 

To identify the network, you must tell RFS which network (transport pro- 
der) it should use. (In our example, this is starlan for the STARLAN net- 
work.) 

dname — N starlan 

This command indicates the device, relative to the /dev directory, that is used 
for the transport provider. 

Create rfmaster File 

The remaster file should only be created manually on the primary. If your 
machine is not the primary, you should skip this task; the remaster file for your 
domain will automatically be placed on your machine the first time you start 
RFS (rfstart -p primary— addr). 

If you are on the primary, you can create an rfmaster file in the 
/usr/nserve directory using any standard file editor. The contents of this file 
^ill define the following: 

• the primary name server for your domain 

• secondary name servers for your domain 

• network addresses for each of these machines 

(See the section on " Multiple Domain Name Service " in this chapter for a 
description of other information you may want to put into the rfmaster file.) 

Here is an example of an rfmaster file for a domain called peanuts, whose 
primary and secondary name servers' node names are charlie, linus, and 
lucy. Adding each machine's domain name (peanuts) to its node name, 
separated by a period, forms its full RFS machine name. Each line of the 
example translates as follows: 

• For domain peanuts, the primary is peanuts.charlie. 

• For domain peanuts, a secondary is peanuts.linus. 

• For domain peanuts, another secondary is peanuts.lucy. 
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